Admin Production ni-theme
Current Publication

GetNumListItems

LabWindows/CVI

GetNumListItems

int GetNumListItems (int panelHandle, int controlID, int *count);

Purpose

Returns the number of list items in the specified control.

Supported Controls

You can use GetNumListItems with the following 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.
Output
Name Type Description
count int The number of items in the list control. Because the indices are zero based, this value is one greater than the index of the last item.

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 3.0 and later

Examples

Refer to the following examples that use the GetNumListItems function:

  • apps\uirview\uirview.cws

    Open example
  • toolbox\XMLSample.cws

    Open example
  • userint\imagedit.cws

    Open example
  • userint\listbox.cws

    Open example
  • userint\treesearch.cws

    Open example