DuplicatePanel
- Updated2023-02-21
- 2 minute(s) read
DuplicatePanel
int DuplicatePanel (int destParentPanelHandle, int originalPanelHandle, char duplicatePanelTitle[], int panelTop, int panelLeft);
Purpose
Duplicates a panel into the specified destination parent panel and returns the duplicate (new) panel handle.
Parameters
| Input | ||
| Name | Type | Description |
| destParentPanelHandle | int | Handle for the parent panel into which to copy the duplicate panel. To make
the panel a top-level panel, pass 0. You can obtain this handle from functions such as LoadPanel and NewPanel. |
| originalPanelHandle | int | Handle of the original panel to duplicate. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel. |
| duplicatePanelTitle | char [] | Title of the duplicate (new) panel. Pass "" for no title. Pass 0 to use the title of the original panel. |
| panelTop | int | Vertical coordinate at which to place the upper left corner of the panel,
directly below the title bar. Pass VAL_KEEP_SAME_POSITION to keep the same top coordinate as the original panel. The coordinates must be integer values from –32,768 to 32,767 or VAL_AUTO_CENTER to center the panel. For a top-level panel, (0,0) is the upper-left corner of the screen. For a child panel, (0,0) is the upper-left corner of the parent panel, directly below the title bar, before the parent panel is scrolled. |
| panelLeft | int | Horizontal coordinate at which to place the upper left corner of the panel,
directly below the title bar. Pass VAL_KEEP_SAME_POSITION to keep the same left coordinate as the original panel. The coordinates must be integer values from –32,768 to 32,767 or VAL_AUTO_CENTER to center the panel. For a top-level panel, (0,0) is the upper-left corner of the screen. For a child panel, (0,0) is the upper-left corner of the parent panel, directly below the title bar, before the parent panel is scrolled. |
Return Value
| Name | Type | Description |
| panelHandle | int | Value you can use in subsequent function calls to specify this panel. Negative values indicate that an error occurred. Zero is not a valid panel handle. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later