Purpose

This example demonstrates the following two approaches for creating Message Popup steps that automatically dismiss after a condition is met:

• Dismissing the message after a set amount of time
• Dismissing the message after a set condition is met, such as detecting that a new UUT has been attached to the test fixture

Example File Location

<TestStand Public>\Examples\Built-In Step Types\Message Popup Step Type\Message Popup Step Type - Automatically Dismissing.seq

Highlighted Features

• Message Popup Timeout
• Creating New Executions

Major API

Execution.Terminate

Prerequisites

None

How to Use This Example

Complete the following steps to review the sequences and steps in this example:

1. Select the UUT Detected step. In the Step Settings pane, select the Text and Buttons tab.
2. Observe that Button 1 is specified in the Timeout Button field, and the Time to wait field is set to three seconds. This setting configures the step to automatically select Button 1 and dismiss the message box after three seconds.
3. Select the Prompt for User Action sequence. Observe that this sequence creates a new execution to launch the dialog. The sequence will dismiss the dialog by terminating the execution.
   Note The Launch Dialog in new Execution step stores a reference to the new execution in the Locals.messageExecution variable using the Sequence Call Advanced Settings dialog box.
4. After launching the dialog, the sequence simulates polling for a UUT. In a real application, this section would typically call a code module which returns once the condition is met
5. Once the condition is met, the Execution.Terminate method of the TestStand API terminates the new execution, thereby dismissing the message popup.

Complete the following steps to run the example:

1. Select Execute»Single Pass to run the sequence.
2. Observe that the first message popup dismisses after three seconds.
3. Observe that the second message popup step dismisses once the Check for UUT condition is met.