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