Admin Production ni-theme
Current Publication

InsertPanelAsTabPage

LabWindows/CVI

InsertPanelAsTabPage

int InsertPanelAsTabPage (int panelHandle, int controlID, int index, int panelToInsert);

Purpose

Copies a panel you specify and inserts the panel onto a tab control at the index you specify.

Supported Controls

You can use InsertPanelAsTabPage with tab controls.

Parameters

Input
Name Type Description
panelHandle int Specifier for a particular panel that is currently in memory. You can obtain this handle from functions such as LoadPanel and NewPanel.
controlID int The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by functions such as NewCtrl and DuplicateCtrl.
index int Zero-based index into the list where InsertPanelAsTabPage places the new tab page. Pass –1 to insert the new tab page at the end of the list.
panelToInsert int The panelHandle of the panel to copy and insert onto the tab control.

Return Value

Name Type Description
newTabIndex int Returns the index of the new tab page. Use this index to specify the tab page index in subsequent function calls. Negative values indicate that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 8.1 and later

Example

Refer to userint\tabpanels.cws for an example of using the InsertPanelAsTabPage function.