* * HELP & MANUAL PREMIUM PACK 4 DEMO VERSION * *
This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Meta function automatically created by thinBasic engine and valid only inside Callback Functions.
This meta function is valid only inside a Callback Function,
It returns the window handle of the caller.
Syntax
hWin = CBHNDL
alias
hWin = Callback_Handle
Returns
Number.
Remarks
When a user clicks on a button, types into a text box, or generally interacts with any in a dialog, Windows sends a %WM_COMMAND message to the control callback function. If no control callback function is defined, the message is sent to the dialog callback function. In either type of callback, CBHNDL returns the window handle of the parent dialog. CBHNDL will also return the window handle for all other types of messages that flow through dialog callback functions. For example, %WM_PAINT, %WM_INITDIALOG, etc.
As it is possible to share a control callback function with multiple controls, it is also possible to share a dialog callback function with multiple dialogs. In such cases, CBHNDL can be used to make a clear distinction between each dialog.
Restrictions
This function is only valid inside a Callback Function.
See also
Examples
