%AX_TKEVENT_SIZE

Size the Toolkit container window

value = %AX_TKEVENT_SIZE(resv_1, resv_2, ^VAL(container_id), 
&      ^VAL(D_EVENT_SIZE), ^VAL(win_width), ^VAL(win_height), 
&      ^VAL(client_width), ^VAL(client_height))

Return value

value

The return value for the method. On Windows, this function always returns true unless the extension returns false. On Unix, this function will cause an error if invoked. On OpenVMS, it returns true. (^VAL)

Arguments

resv_1, resv_2

Reserved for internal use. (a)

container_id

The ID of the Toolkit container window for the ActiveX control. This must be passed by value. (i)

D_EVENT_SIZE

The event code for the event that invokes the extension. This must be passed by value. (i)

win_width

Width of the logical window (number of columns). This must be passed by value. (i)

win_height

Height of the logical window (number of rows). This must be passed by value. (i)

client_width

Width of the client area (number of pixels). This must be passed by value. (i)

client_height

Height of the client area (number of pixels). This must be passed by value. (i)

Discussion

%AX_TKSINGLE and %GRID_CREATE automatically register a %UWNDEVENTS_METHOD set that includes %AX_TKEVENT_SIZE as the routine for the D_EVENT_SIZE event. When the D_EVENT_SIZE event is triggered (programmatically or by the user), %U_WNDEVENTS calls this routine. If prefix (an argument for %AX_TKSINGLE and %GRID_CREATE) was passed and

there’s an extension for the D_EVENT_SIZE event, %AX_TKEVENT_SIZE calls the extension. If the extension routine returns FALSE, %AX_TKEVENT_SIZE returns true without performing any other function. If the extension returns true, %AX_TKEVENT_SIZE resizes the ActiveX container and control by setting their “Ext_Rect” properties to match the client area of the Toolkit container window.
there is no extension for D_EVENT_SIZE, %AX_TKEVENT_SIZE resizes the ActiveX container and control by setting their “Ext_Rect” properties to match the client area of the Toolkit container window and returns true.

(For information on “Ext_Rect”, see Extended properties.)

If you assign your own method set to the window, you can call %AX_TKEVENT_SIZE from the routine you’ve supplied for the D_EVENT_SIZE event.