Message Popup Step

TestStand 2017 Help

Edition Date: November 2017

Part Number: 370052W-01

»View Product Info

Download Help (Windows Only)
NI TestStand 2014 Help
NI TestStand 2014 SP1 Help
TestStand 2016 Help
TestStand 2016 SP1 Help
TestStand 2017 Help

Use a Message Popup step to display messages to the user and to receive response strings from the user. For example, you can use a Message Popup step to warn the user when a calibration routine fails.

By default, Message Popup steps do not pass or fail. After a step executes, TestStand sets the step status to Done or Error.

Configuring the Step

Use the Message Popup edit tabs in the TestStand Sequence Editor and the Configure Message Popup Step dialog box in a TestStand User Interface to specify the settings for the Message Popup step.

Step Properties

In addition to the common custom properties, the Message Popup step type defines the following step properties:

  • Step.Result.ButtonHit—The one-based index of the button you select.
  • Step.Result.Response—The response text the user entered.
  • Step.TitleExpr—The expression for the string that appears as the title of the message popup dialog box.
  • Step.MessageExpr—The expression for the string that appears as the text message in the message popup dialog box.
  • Step.MessageFontData—The font for the text message in the message popup dialog box.
  • Step.Button1Label, Button2Label, Button3Label, Button4Label, Button5Label, and Button6Label—The expression for the label text for each button.
  • Step.ButtonFontData—The font for the label text for buttons in the message popup dialog box.
  • Step.ShowResponse—Enables the response text box control in the message popup dialog box.
  • Step.NumberLines—The number of visible text lines in the response text box.
  • Step.MaxResponseLength—The maximum number of characters the user can enter in the response text box control.
  • Step.RespFontData—The font for the response text box control in the message popup dialog box.
  • Step.DefaultResponseExpr—The initial text string the step displays in the response text box control.
  • Step.FileData—The step displays an image or web page in the message popup dialog box.
  • Step.ActiveCtrl—Identifies one of the six buttons or the input string as the active control.
  • Step.DefaultButton—Specifies which button, if any, uses <Enter> as a shortcut key.
  • Step.CancelButton—Specifies which button, if any, uses <Esc> as a shortcut key.
  • Step.TimerButton—The index of the button that activates automatically after a timeout elapses. A value of zero indicates no timeout occurs.
  • Step.TimeToWait—The number of seconds before the button Step.TimerButton specifies activates.
  • Step.Position.Top and Step.Position.Left—The location of the message popup dialog box when CenterDialog is False.
  • Step.CenterDialog—The message popup dialog box appears in the center of the screen.
  • Step.Modal—The message popup dialog box is modal to the TestStand application.
  • Step.Floating—The message popup dialog box appears on top of the TestStand application.
  • Step.CtrlArrangement—The order for the controls in the message popup dialog box.
  • Step.ButtonLocation—Specifies whether to display the buttons on the bottom or side of the message popup dialog box.
  • Step.ButtonAlignment—Specifies whether to align the buttons in the center, left, right, top, or bottom of the message popup dialog box.
  • Step.ResizeDialog—Specifies whether the message popup dialog box is resizable.

See Also

Built-In Step Types

WAS THIS ARTICLE HELPFUL?

Not Helpful