|
<< Click to Display Table of Contents >> Navigation: ThinBASIC Modules > UI (User Interface) > CONTROLS > Control Types > Tab Control > Tab Control Commands > TAB_PageInsert |
Description
Insert a new page into a Tab control.
Syntax
PageHwnd = TAB_PageInsert hwnd, ctrlID, PageNo, ImageID, sText [[,] CALL CallBack]
Returns
Number
The handle of the newly created window inside the page.
Parameters
Name |
Type |
Optional |
Meaning |
hwnd |
Number |
No |
Handle of the dialog containing the control |
ctrlID |
Number |
No |
Control identifier |
PageNo |
Number |
No |
Page position number |
ImageID |
Number |
No |
---For future use--- |
sText |
String |
No |
Text to be displayed into page TAB |
CallBack |
Function |
Yes |
Optional name of a Callback Function that receives all %WM_COMMAND and %WM_NOTIFY messages for the control.
If a callback for the control is not designated, you must create a dialog Callback Function to process messages from your control.
If the Callback Function processes a message, it should return %TRUE (non-zero) to prevent the message being passed unnecessarily to the dialog callback (if one exists). The dialog callback should also return %TRUE if the notification message is processed by that Callback Function. |
Remarks
This command not only creates a page in a TAB control but also create a new window that will be used to add more child controls over the TAB page. The new window has all the characteristics of a read window: can contains child controls, can be resized (see TAB automatic handling events), can responds to events using dedicated callback function.
Restrictions
See also
Examples