Admin Production ni-theme
Current Publication

GetCtrlArrayFromResourceID

LabWindows/CVI

GetCtrlArrayFromResourceID

int GetCtrlArrayFromResourceID (int panelHandle, int resourceID);

Purpose

Returns the control array handle associated with the resource ID that was loaded into memory when the panel was loaded.

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.
resourceID int Defined constant that was assigned to the control array in the User Interface EditorUser Interface Editor.

The resourceID is found in the .uir header file and you use it only to load the control array into memory. You use the control array handle returned by this function to refer to the control array in subsequent function calls.

Return Value

Name Type Description
controlArrayHandle int Returns the handle you can use to specify the control array in subsequent function calls. Negative values indicate that an error occurred. Zero is not a valid handle.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 2010 and later

Example

Refer to userint\ledctrlarray.cws for an example of using the GetCtrlArrayFromResourceID function.