C_METHTS
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
subroutine C_METHTS, reentrant in req container_id ,n in req type ,n in req child_id ,n in req reason ,a opt record ,a opt a_methoddata1 ,any . . . opt a_methoddata20 ,any
Arguments
container_id
This argument is not used by the default processing methods. However, it passes the ID of the container window in case a method you supply needs this information. (n)
type
This argument is not used by the default processing methods. However, it passes one of the following (defined in tools.def) in case a method you supply needs this: DC_LIST for a standard Toolkit list or an ActiveX Toolkit list, or DC_WINDOW for a Toolkit window. (n)
child_id
The ID for the child tabbed dialog. (n)
reason
The reason the child was activated, which can be blank (indicating that the child was already activated), a program-supplied reason passed because the child was activated programmatically, or one of the following: (a)
C_FIRST = Focus moved in attempt to reach first child.
C_LAST = Focus moved in attempt to reach last child.
C_NEXT = Focus moved from previous child (e.g., tab).
C_PREV = Focus moved from next child (e.g., shift+tab).
C_SET = Child explicitly activated. For example, this could be the result of a mouse click, or it could be that the child was activated programmatically without a specified reason.
record
(optional) This argument is not used by the default method C_METHAX. However, this argument passes a copy of the a_methoddata argument specified by recordindex (a DC_ADD argument) for other methods that need this information. (a)
a_methoddata1 through a_methoddata20
(optional) Up to 20 additional data arguments. (any)
Discussion
C_METHTS is a Toolkit-supplied processing method that C_PROCESS calls by default when processing a child window that is a tabbed dialog. If you want something other than the default processing described below, you can instruct C_PROCESS to call a different routine by passing the routine’s name in the DC_ADD call for the list.
C_METHTS does the following:
1. | Establishes focus for the tab set by passing the reason argument on to the DTS_CTRCONTEXT subfunction of %TS_TABSET. (Note that the DTS_CTRCONTEXT subfunction for %TS_TABSET is designed specifically to be used in processing methods for child windows that are tabbed dialogs. See DTS_CTRCONTEXT for more information.) |
2. | Processes the tabbed dialog by calling %TS_PROCESS with the ID of the child window and all the a_methodata arguments passed in the C_PROCESS call. |
To view the code for this method, see the ctrmeths.dbl file included in your UI Toolkit distribution. This file is distributed simply as a reference and a starting point for writing your own composite window processing methods; modifying or compiling this file will not change the default methods. |
See also
- Controlling tabbing, focus, and input context for information on tabbing indices.
- DC_ADD subfunction of the %C_CONTAINER routine
- C_PROCESS routine
- Overloading UI Toolkit routines