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