VI Properties Dialog Box (Application Builder)

Requires: Base Development System

From the Source File Settings page of the Application Properties, Shared Library Properties, Source Distribution Properties, click the Customize VI Settings button to display this dialog box.

Use this dialog box to configure settings for VIs included in an application, shared library, or source distribution.

The options in this dialog box correspond with the options in the VI Properties dialog box that you access from the File menu. If you make changes to the VI properties in this dialog box, those changes override any changes you made in the VI Properties dialog box menu from the File menu.

This dialog box includes the following components:

• Use VI Property—Uses the property settings configured in the VI.
• Window Appearance—Corresponds to options in the Customize Window Appearance dialog box. If you remove the checkmark from any of the Use VI Property checkboxes and configure settings in this dialog box, the settings you configure in this dialog box override any settings you configured in the Customize Window Appearance dialog box.
  • Window has title bar—Displays the title bar, which includes the title and the Minimize, Maximize, and Close buttons. You also can use the Front Panel Window:Title Bar Visible property to automatically display a title on the front panel.
  • Show menu bar—Displays the menu bar. You also can use the Show Menu Bar property to display the menu bar programmatically.
  • Show vertical scroll bar—Displays the vertical scroll bar. If you hide the vertical and horizontal scroll bars, the user can reveal the hidden parts of the front panel only by expanding the front panel. If you scale the front panel objects or disallow resizing of the front panel, the user cannot reveal the hidden parts of the front panel.

    If you turn off the vertical scroll bar by right-clicking the scroll bar in the front panel window and selecting Vertical Scrollbar»Always Off, you can display the scroll bar again by enabling the Show vertical scroll bar option in this dialog box.

    Note  The option reflects the settings of the upper-leftmost pane when splitter bars are on the front panel.

    You also can use the Vertical Scrollbar Visibility property to display the scroll bar programmatically.
  • Show horizontal scroll bar—Displays the horizontal scroll bar. If you hide the horizontal and vertical scroll bars, the user can reveal the hidden parts of the front panel only by expanding the front panel. If you scale the front panel objects or disallow resizing of the front panel, the user cannot reveal the hidden parts of the front panel.

    If you turn off the horizontal scroll bar by right-clicking the scroll bar in the front panel window and selecting Horizontal Scrollbar»Always Off, you can display the scroll bar again by enabling the Show horizontal scroll bar option in this dialog box.

    Note  If you add a splitter bar to the front panel, you cannot change this option. The behavior remains as you set it before you added the splitter bar.

    You also can use the Horizontal Scrollbar Visibility property to display the scroll bar programmatically.
  • Show toolbar when running—Displays the toolbar when the VI runs. You also can use the Tool Bar:Visible property to programmatically display the toolbar when the VI runs.
  • Show Abort button—Displays the Abort button in edit mode and in run mode. You also can use the Tool Bar:Show Abort Button property to display the abort button programmatically.
  • Show front panel when called—Automatically opens the front panel when the subVI is called. You also can use the Show Front Panel On Call property to display the front panel programmatically.
  • Window behavior—Sets the behavior of the front panel window. You also can use the Front Panel Window:Behavior property to set the behavior programmatically. LabVIEW applies this property when the VI is running or reserved for running.
    • Default—Resets the front panel to its default behavior so it does not behave as a floating or modal window.
    • Floating—Keeps the front panel on top of all other non-floating LabVIEW windows, except modal windows. Unlike other floating windows in LabVIEW, such as the Controls and Functions palettes, you do not have to click on the title bar to give focus to a floating front panel window. Instead, you can click anywhere in the window. Floating front panel windows also do not relinquish focus immediately after receiving it. (Windows and macOS) If multiple floating windows are open, the last one whose title bar you click appears on top.
    • Modal—Keeps the front panel on top of all other LabVIEW windows until you close the window or open another modal window. You cannot interact with other windows while a modal window is open. Most dialog boxes in LabVIEW are modal windows, such as the Options dialog box. (macOS) The operating system ignores settings for the Close, Minimize, and Maximize window buttons when you select Modal.
  • Allow user to close window—Allows you to close the VI window.

  • Window run-time position—Sets the position of the front panel window on the computer screen.

    You also can use the Front Panel:Center method to center the front panel window programmatically.

• Execution—Corresponds to options on the Execution page of the File»VI Properties dialog box.
  • Run when opened—Enables a VI to enter run mode and run automatically when you open it. You also can use the Run When Opened property to programmatically run a VI when it opens. To edit a VI set to run when opened, place it on the block diagram of a new, blank VI and double-click it.

    Note  LabVIEW ignores this option in the following scenarios: When you use the VI Server to load the VI. Use the Run VI method to run a VI you use the VI Server to load. When you designate the VI as a startup VI in a built application. Startup VIs run when they are opened by default and LabVIEW overrides the option you set in this dialog box. You can configure a startup VI to not run when it is opened when you configure the build specification. On the Source File Settings page of the Application Properties dialog box, click the Customize VI Properties button. In the VI Properties (Application Builder) dialog box, remove the checkmark from the Run when opened checkbox.

  • Allow debugging—Allows debugging on this VI. For example, you can set breakpoints, create probes, enable execution highlighting, and single-step through execution. Remove the checkmark from this checkbox to reduce memory requirements and to improve performance slightly. You also can use the Allow Debugging property to allow debugging on a VI programmatically.
  • Enable automatic error handling—Activates automatic error handling for the block diagram of the current VI. When the VI runs, LabVIEW suspends execution, highlights the subVI or function where the error occurred, and displays an error dialog box. You also can use the Automatic Error Handling property to enable automatic error handling for a VI programmatically.

    Note  The LabVIEW Run-Time Engine does not support automatic error handling.