Create a Toolkit container and load a single ActiveX control

WTSupported in traditional Synergy on Windows




window_id = %AX_TKSINGLE(tk_container_name, rows, columns, control_name, [ocx_file], 
&          [license_string][, prefix])

Return value


On Windows, %AX_TKSINGLE returns the ID of the created Toolkit container window. On UNIX, this routine always returns false. On OpenVMS, this routine always returns true. (^VAL)



The name of the Toolkit container window to create. (a)


The number of rows to initially size the window. (n)


The number of columns to initially size the window. (n)


The name of the ActiveX control you want to load. (a)


(optional) The name of the OCX file that contains the control. (a)


(optional) The optional license string for the control. (a)


(optional) The optional prefix for binding extension routines to the automatically registered %UWNDEVENTS_METHOD set and for auto-binding control events. (See the documentation for the autobind_prefix argument for %AX_LOAD.) If you pass prefix to %AX_TKSINGLE, it is used in two places: for the %UWNDEVENTS_METHOD set that is registered for the Toolkit container window and for binding (AX_BIND) routines to each of the control events. (a)


%AX_TKSINGLE does the following:

%AX_TKSINGLE loads only one ActiveX control per Toolkit container. (To use more than one ActiveX control in a single Toolkit container, you must use %AX_TKWIN.) You maintain only one ID: the window ID returned by %AX_TKSINGLE. The resulting Toolkit container window is part of the current environment, but can be promoted to global.

%AX_TKSINGLE automatically registers a default method set that includes an entry for each event. For example, for D_EVENT_LEFT_CLICK, there’s an %AX_TKEVENT_LEFT_CLICK entry. (The names for these routines all begin with AX_TKEVENT_.) This method set also includes %AX_TKEVENT_SIZE (for the D_EVENT_SIZE event), which automatically resizes the ActiveX control when the user or the program resizes the Toolkit container window.

If you want to create your own routines for these events, there are three ways to replace these methods: by creating extensions, by creating your own routines with the same name and linking them in at runtime, or by registering your own method set. We recommend extensions, which are routines you write whose names have a common prefix, but otherwise are modeled after the event names for the AX_TKEVENT_* supplied methods (documented in Supplied methods). For example, if the common prefix is GRID_ and you create an extension for the left click event, your extension would need to be named GRID_TKEVENT_LEFT_CLICK. You then pass the prefix (“GRID_”, in this case) as the prefix argument to %AX_TKSINGLE.

Note the following:

If you pass a null string (“”) for tk_container_name, Toolkit assigns a unique window name in the form _W_nnn, where nnn is the window ID.

If the ActiveX control cannot be loaded and the ocx_file argument

See also


The following example creates a Toolkit container window, creates an ActiveX container, and loads the MSCAL.Calendar ActiveX control. When the CAL_SELECT menu entry is signaled, a message box is displayed indicating the currently selected date in the calendar control.

    xcall u_start
    wndid = %ax_tksingle("", 10, 40, "MSCAL.Calendar", "mscal.ocx",, "calendar_")
    xcall b_button(wndid, "CAL_SELECT", DSB_TEXT, "OK")
    xcall b_button(wndid, "O_EXIT", DSB_TEXT, "Cancel")
    xcall u_window(D_PLACE, wndid, 5, 21)
        xcall ax_input(wndid)
        if (g_select)
          using g_entnam select
("CAL_SELECT"), begin
          xcall u_message("Selected date (MM/DD/YYYY): " +
          &          %string(%ax_tkgetint(wndid, "Month")) + "/" +
          &          %string(%ax_tkgetint(wndid, "Day"), "XX") + "/" +
          &          %string(%ax_tkgetint(wndid, "Year"), "XXXX"))
(),            exitloop
    xcall u_finish