int DuplicateCtrl (int sourcePanelHandle, int controlID, int destinationPanelHandle, char duplicateLabel[], int controlTop, int controlLeft);
Copies an existing control from the source panel to the destination panel and returns a control ID. You can use the control ID to reference the control in subsequent function calls.
Input | ||
Name | Type | Description |
sourcePanelHandle | integer | Handle of the source panel containing the control to duplicate. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel. |
controlID | integer | 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 NewCtrl or DuplicateCtrl. |
destinationPanelHandle | integer | The parent panel into which to copy the duplicate control. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel. |
duplicateLabel | string | Label for the duplicate control. Pass "" for no label. Pass 0 to use the label of the source control. |
controlTop | integer | Vertical coordinate at which to place the upper left corner of the control,
not including labels. The valid range for controlTop is –32,768 to 32,767 or VAL_KEEP_SAME_POSITION. The origin (0,0) is at the upper-left corner of the panel, directly below the title bar, before the panel is scrolled. |
controlLeft | integer | Horizontal coordinate at which to place the upper left corner of the control,
not including labels. The valid range for controlLeft is –32,768 to 32,767 or VAL_KEEP_SAME_POSITION. The origin (0,0) is at the upper-left corner of the panel, directly below the title bar, before the panel is scrolled. |
Name | Type | Description | ||||
newID | integer | Returns the ID you use to specify the new (duplicate) control in subsequent
function calls. Negative values indicate that an error occurred. Zero is not a valid ID.
|