EasyTab_AddPanels

int EasyTab_AddPanels (int panel, int tabControl, int row, . . .);

Purpose

This function adds the specified panels to the Tab control. The panels must already be in memory and must be child panels of the panel that owns the Tab control.

Note  The label on each panel's tab is the same as the title of the panel. A pair of underscores may be placed before a character in the panel title to specify that character as an underline accelerator.

Parameters

Input
Name Type Description
panel integer The specifier for a particular panel that is currently in memory.

This handle will have been returned by the LoadPanel, NewPanel, or DuplicatePanel function.
tabControl integer The ID returned by the EasyTab_Create or EasyTab_ConvertFromCanvas function.
row integer Specifies the row to which to add the tab buttons for the specified panels.

Row numbers begin at 1. Gaps betweens rows are not allowed. For example, you cannot add panels to row 2 before you have added at least one panel to row 1.
listOfPanelHandles A zero-terminated argument list of panel handles.

The values of the listed panels must be handles to child panels of the panel that owns the Tab control.

Example:

int panel1, panel2, panel3;

panel1 = NewPanel(parentPanel, ...);
panel2 = LoadPanel(parentPanel, ...);
panel3 = LoadPanel(parentPanel, ...);
EasyTab_AddPanels(parentPanel, tabCtrl, row, panel1,     panel2, panel3, 0);
Note   A zero (0) MUST be the last parameter. This function relies on finding a panel handle with the value of zero to determine when the list of panels ends.
Note   Because all panels added to a Tab control must be child panels of the Tab control's parent panel, they are automatically discarded when the parent panel is discarded.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

The possible negative error codes are:
Return Values: 0   Success
–1 to –999 A User Interface Library error code. (Constants are available in userint.h.)
–5000 to –5499 A Toolbox instrument driver error code. (Constants are available in toolbox.h.)

A description of any of these error codes can be obtained using the GetGeneralErrorString function in the toolbox.fp instrument driver.