LabWindows/CVI

Table of Contents
  • LabWindows/CVI Fundamentals
  • Creating Applications
  • Distributing Applications
  • Library Reference
  • Programmer Reference
  • Hardware Information

NewCtrl

int NewCtrl (int panelHandle, int controlStyle, char controlLabel[], int controlTop, int controlLeft);

Purpose

Creates a new control and returns a control ID that you can use to specify the control in subsequent function calls.

If you call this function to add a timer control to a panel, you must do so in the same thread in which you create or load the panel.

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.
controlStyle int Select one of the following control styles.

Type Style
Numeric CTRL_NUMERIC
CTRL_NUMERIC_LS
Color Numeric CTRL_COLOR_NUMERIC
CTRL_COLOR_NUMERIC_LS
Numeric Slide CTRL_NUMERIC_THERMOMETER
CTRL_NUMERIC_THERMOMETER_LS

CTRL_NUMERIC_TANK
CTRL_NUMERIC_TANK_LS

CTRL_NUMERIC_GAUGE
CTRL_NUMERIC_GAUGE_LS

CTRL_NUMERIC_METER
CTRL_NUMERIC_METER_LS

CTRL_NUMERIC_KNOB
CTRL_NUMERIC_KNOB_LS

CTRL_NUMERIC_DIAL
CTRL_NUMERIC_DIAL_LS

CTRL_NUMERIC_VSLIDE

CTRL_NUMERIC_HSLIDE

CTRL_NUMERIC_FLAT_VSLIDE

CTRL_NUMERIC_FLAT_HSLIDE

CTRL_NUMERIC_LEVEL_VSLIDE
CTRL_NUMERIC_LEVEL_VSLIDE_LS

CTRL_NUMERIC_LEVEL_HSLIDE
CTRL_NUMERIC_LEVEL_HSLIDE_LS

CTRL_NUMERIC_POINTER_VSLIDE
CTRL_NUMERIC_POINTER_VSLIDE_LS

CTRL_NUMERIC_POINTER_HSLIDE
CTRL_NUMERIC_POINTER_HSLIDE_LS
String CTRL_STRING
CTRL_STRING_LS
Text Message CTRL_TEXT_MSG
Text Box CTRL_TEXT_BOX
CTRL_TEXT_BOX_LS
Command Button CTRL_SQUARE_COMMAND_BUTTON
CTRL_SQUARE_COMMAND_BUTTON_LS

CTRL_OBLONG_COMMAND_BUTTON

CTRL_ROUND_COMMAND_BUTTON

CTRL_ROUNDED_COMMAND_BUTTON
Picture Button CTRL_PICTURE_COMMAND_BUTTON
CTRL_PICTURE_COMMAND_BUTTON_LS

CTRL_PICTURE_TOGGLE_BUTTON
CTRL_PICTURE_TOGGLE_BUTTON_LS
Toggle Button CTRL_ROUND_BUTTON

CTRL_SQUARE_BUTTON
CTRL_SQUARE_BUTTON_LS

CTRL_ROUND_FLAT_BUTTON

CTRL_SQUARE_FLAT_BUTTON

CTRL_ROUND_PUSH_BUTTON

CTRL_SQUARE_PUSH_BUTTON
CTRL_SQUARE_PUSH_BUTTON_LS

CTRL_ROUND_PUSH_BUTTON2

CTRL_SQUARE_PUSH_BUTTON2
Text Button CTRL_SQUARE_TEXT_BUTTON
CTRL_SQUARE_TEXT_BUTTON_LS

CTRL_OBLONG_TEXT_BUTTON

CTRL_ROUND_TEXT_BUTTON

CTRL_ROUNDED_TEXT_BUTTON
Radio Button CTRL_ROUND_RADIO_BUTTON

CTRL_SQUARE_RADIO_BUTTON

CTRL_CHECK_BOX
LED CTRL_ROUND_LIGHT

CTRL_SQUARE_LIGHT

CTRL_ROUND_LED
CTRL_ROUND_LED_LS

CTRL_SQUARE_LED
CTRL_SQUARE_LED_LS
Binary Switch CTRL_HSWITCH

CTRL_VSWITCH

CTRL_GROOVED_HSWITCH

CTRL_GROOVED_VSWITCH

CTRL_TOGGLE_HSWITCH
CTRL_TOGGLE_HSWITCH_LS

CTRL_TOGGLE_VSWITCH
CTRL_TOGGLE_VSWITCH_LS
Ring CTRL_RING
CTRL_RING_LS

CTRL_RECESSED_MENU_RING
CTRL_RECESSED_MENU_RING_LS

CTRL_MENU_RING
CTRL_MENU_RING_LS

CTRL_POPUP_MENU_RING
CTRL_POPUP_MENU_RING_LS
Ring Slide CTRL_RING_VSLIDE

CTRL_RING_HSLIDE

CTRL_RING_FLAT_VSLIDE

CTRL_RING_FLAT_HSLIDE

CTRL_RING_LEVEL_VSLIDE
CTRL_RING_LEVEL_VSLIDE_LS

CTRL_RING_LEVEL_HSLIDE
CTRL_RING_LEVEL_HSLIDE_LS

CTRL_RING_POINTER_VSLIDE
CTRL_RING_POINTER_VSLIDE_LS

CTRL_RING_POINTER_HSLIDE
CTRL_RING_POINTER_HSLIDE_LS

CTRL_RING_THERMOMETER
CTRL_RING_THERMOMETER_LS

CTRL_RING_TANK
CTRL_RING_TANK_LS

CTRL_RING_GAUGE
CTRL_RING_GAUGE_LS

CTRL_RING_METER
CTRL_RING_METER_LS

CTRL_RING_KNOB
CTRL_RING_KNOB_LS

CTRL_RING_DIAL
CTRL_RING_DIAL_LS
Picture Ring CTRL_PICTURE_RING
CTRL_PICTURE_RING_LS
List Box CTRL_LIST
CTRL_LIST_LS
Decoration CTRL_RAISED_BOX
CTRL_RAISED_BOX_LS

CTRL_RECESSED_BOX
CTRL_RECESSED_BOX_LS

CTRL_FLAT_BOX

CTRL_RAISED_CIRCLE

CTRL_RECESSED_CIRCLE

CTRL_FLAT_CIRCLE

CTRL_RAISED_FRAME

CTRL_RECESSED_FRAME

CTRL_RECESSED_NARROW_FRAME

CTRL_FLAT_FRAME

CTRL_RAISED_ROUND_FRAME

CTRL_RECESSED_ROUND_FRAME

CTRL_FLAT_ROUND_FRAME

CTRL_RAISED_ROUNDED_BOX

CTRL_RECESSED_ROUNDED_BOX

CTRL_FLAT_ROUNDED_BOX

CTRL_SMOOTH_VERTICAL_BOX_LS

CTRL_SMOOTH_HORIZONTAL_BOX_LS
Graph CTRL_GRAPH
CTRL_GRAPH_LS
Digital Graph CTRL_DIGITAL_GRAPH
CTRL_DIGITAL_GRAPH_LS
Strip Chart CTRL_STRIP_CHART
CTRL_STRIP_CHART_LS
Picture CTRL_PICTURE
CTRL_PICTURE_LS
Timer CTRL_TIMER
Canvas CTRL_CANVAS
Table CTRL_TABLE
CTRL_TABLE_LS
ActiveX CTRL_ACTIVEX
Tree CTRL_TREE
CTRL_TREE_LS
Splitter CTRL_HORIZONTAL_SPLITTER
CTRL_HORIZONTAL_SPLITTER_LS

CTRL_VERTICAL_SPLITTER
CTRL_VERTICAL_SPLITTER_LS
Tab CTRL_TABS
controlLabel char [] Label of the new control. Pass "" or 0 for no label.

Note: This parameter is ignored for splitters, tabs, and decorations.
controlTop int Vertical coordinate at which to place the upper left corner of the control, not including labels.

The coordinate must be an integer value from –32,768 to 32,767. The origin (0,0) is at the upper-left corner of the panel, directly below the title bar, before the panel is scrolled.
controlLeft int Horizontal coordinate at which to place the upper left corner of the control, not including labels.

The coordinate must be an integer value from –32,768 to 32,767. The origin (0,0) is at the upper-left corner of the panel, directly below the title bar, before the panel is scrolled.

Return Value

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

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

  • userint\buildui.cws

    Open example
  • userint\ICOViewer.cws

    Open example

Log in to get a better experience