Please enable JavaScript to view this site.

thinBasic Help Manual

* * 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

 

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

 

Created with Help+Manual 8 and styled with Premium Pack Version 4 © by EC Software