C_METHAX

Process a child ActiveX window

subroutine C_METHAX, 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 information: 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 Toolkit container for the ActiveX control. (See Containers for ActiveX controls for information.) (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) These arguments are not used by the default method C_METHAX. However, up to 20 additional data arguments are passed for other methods that need this information. (any)

Discussion

C_METHAX is a Toolkit-supplied processing method that C_PROCESS calls by default when processing a child ActiveX window. 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 window.

C_METHAX does the following:

Calls U_CTRCONTEXT to set context within the ActiveX window.

Calls AX_INPUT to process input.

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.