InsertCtrlArrayItem
- Updated2023-02-21
- 1 minute(s) read
InsertCtrlArrayItem
int InsertCtrlArrayItem (int controlArrayHandle, int panelHandle, int controlToInsert, int index);
Purpose
Inserts a control into the specified control array.
Supported Controls
You can use InsertCtrlArrayItem with all LabWindows/CVI user interface controls.
Parameters
| Input | ||
| Name | Type | Description |
| controlArrayHandle | int | Specifier for a particular control array that is currently in memory. You obtain this handle from GetCtrlArrayFromResourceID or NewCtrlArray. |
| panelHandle | int | Specifier for the panel that contains the control you want to insert into the control array. You can obtain this handle from functions such as LoadPanel and NewPanel. |
| controlToInsert | int | The controlID of the control to insert into the control array. |
| index | int | Zero-based index into the control array where the control is placed. Pass –1 to insert the control at the end of the control array. |
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 2010 and later