LabWindows/CVI

Content Type
Programming Language
Current manual

SetInputMode

SetInputMode

int SetInputMode (int panelOrMenuBarHandle, int controlOrMenuItemID, int inputMode);

Purpose

Controls whether LabWindows/CVI recognizes user input on a panel, control, menum bar, menu, or menu item.

When you disable the input mode of an object, it appears dim on the screen.

Supported Controls

You can use SetInputMode with all LabWindows/CVI user interface controls.

Parameters

Input
Name Type Description
panelOrMenuBarHandle int Handle of the panel or menu bar on which you want to set the recognition of user input.

Use –1 to specify all panels and all menubars.
controlOrMenuItemID int ID of the control or menu item on which you want to set the recognition of user input.

The ID is the defined constant you assign to the control or menu item in the User Interface Editor or the ID that you obtain from NewCtrl or NewMenuItem.

Use –1 to specify all controls on the panel or all items in the menu bar.
inputMode int Specify a nonzero value or select enabled in the function panel to enable user input.

Specify 0 or select disabled in the function panel to disable user input.

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 SetInputMode function:

  • apps\daqmthread\daqMT.cws

    Open example
  • utility\launchexe.cws

    Open example
Was this information helpful?