Control editor

From LabVIEW Wiki
Jump to: navigation, search

Note: This article uses the term "control" and "indicator" interchangeably.

The Control editor provides the ability to create and modify controls, type definitions and strict type definitions. It works like a front panel but it can only contain a single control and doesn't have a block diagram.

Ways to open the control editor

The control editor can be opened in multiple ways:

  • By opening an existing control or control template file.
  • From the Getting Started Window via the File menu option New..., by selecting Other Files >> Custom Control.
  • From the right-click menu of a control via Advanced >> Customize....
  • From the Front Panel of a VI via the Edit menu option Customize Control....

Purpose of the control editor

Examples of visual control customization on a front panel using a Push Button

The visual appearance of controls (their shape, coloring, visibility of elements, font and state) can be changed directly on the front panel of a VI. It is, however, not possible to change the fundamental parts (icons, images, relative positions, ...). This can only be done in the control editor.

Also, the control editor allows to store controls on disk for later re-use and to specify the type of control which changes how new instances of the control are related to each other:


Invalid Control button

Invalid Control error in the control editor window (because it contains two controls)

The Invalid Control button appears at the menu bar when the editor contains invalid elements, for example when the editor contains more than one control. This button opens the Error list dialog with further error details.


Modes

The control editor has two modes: Edit Mode, which works like a regular front panel, and Customize Mode, which detaches individual parts of the control (icon, frame, label, ...). There are multiple ways to switch between modes if the control is valid:

  • By clicking the Change to Customize Mode and Change to Edit Mode button, respectively.
  • Using the Operate menu option Change to Customize Mode and Change to Edit Mode, respectively.
  • Using the Window menu option Show Parts Window (forces the editor into customize mode, even if the control is invalid).
  • With the key-combination Ctrl+M to toggle between modes.

Edit Mode

In Edit Mode controls can be customized the same way as on a front panel. There are, however, a few additional functionalities that are unique to the control editor:

Customize Mode

Individual parts of a control (Push Button)
Individual parts of a control (Push Button) spread apart in the control editor

In Customize Mode individual parts of the control are disconnected and can be changed and relocated. Depending on the type (button, graph, list, ...) and style (Classic, Modern, System, Silver, NXG) of control, the number and type of parts can vary. It is therefore important to begin with the right control to get the desired flexibility. For example, the mouse hover effect is only available for controls of type System, Silver and NXG.

Important note: It is not possible to add or remove parts from a control. This is a limitation of LabVIEW that was fixed in NXG[citation needed].

Each part is surrounded by a white rectangle. Because parts are often placed on top of each other to achieve the desired visual effect, the Control Parts window allows to scroll and select specific parts. The selected part can then be changed via right-click menu options.

When switching back to Edit Mode, all parts keep their current (relative) position, size and visual appearance.


Control Parts window

This is the Control Parts window

The Control Parts window appears when selecting Show Parts Window from the Window menu. It contains a picture ring with the individual parts of the current control and input boxes to change the position and dimension of the currently selected part.


Right click menu options

Option Description
Copy to Clipboard Copies the value (text or picture) of the part to clipboard.
Import Picture from Clipboard This option is only available if the clipboard contains a picture. Adds the picture as background image for text items or substitutes the current picture for picture items. The item size will fit the size of the picture.
Import from Clipboard at Same Size This is the same as Import Picture from Clipboard, but the picture is scaled to fit the size of the item.
Import from File... Opens the file browser to select a picture file. Adds the picture as background image for text items or substitutes the current picture for picture items. The item size will fit the size of the picture.
Import from File at Same Size... This is the same as Import from File..., but the picture is scaled to fit the size of the item.
Revert Reverts the item to its last saved state.
Original Size Restores the last saved size of the item.

Depending on the type of part, additional menu options are available:

Picture Item

Option Description
Picture Item Opens a list of picture items. Selecting an picture from the list will change the value of the item to the selected value.
Independent Sizes When enabled, the size of all picture items are independent. This option is disabled by default.

Label

Option Description
Size To Text When enabled, the size of the item automatically adjusts to the size of the contained text.
Vertical Arrangement Changes the text direction (None, Stacked, Clockwise, Counterclockwise). The default setting is "None".
Lock Label Locks the label in place, so that the entire control moves with the label. This option is disabled by default.

Text Item

Option Description
Text Item Opens a preview of text items.

Import Picture to Clipboard...

Opens a file dialog to select a picture that is imported to clipboard.

See also

External links

References