PostUIMessage Method

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

Syntax

Engine.PostUIMessage ( executionParam, threadParam, eventCode, numericDataParam, stringDataParam, activeXDataParam, synchronous)

Purpose

Posts a user interface message to the current sequence editor or user interface.

Remarks

You can post the following messages from a step: UIMsg_ProgressPercent and UIMsg_ProgressText. These messages tell the user interface to display a progress indicator or text message for the execution.

Parameters

executionParam As Execution

[In] Specifies the execution to pass with the message.

threadParam As Thread

[In] Specifies the thread to pass with the message.

eventCode As UIMessageCodes

[In] Specifies the type of UIMessage.

numericDataParam As Double

[In] Specifies numeric data to pass with the message. When you post a UIMsg_ProgressPercent event, this parameter specifies the percent done.

stringDataParam As String

[In] Specifies string data to pass with the message. When you post a UIMsg_ProgressText event, this parameter specifies the text to display.

activeXDataParam As IUnknown

[In] Specifies an ActiveX reference to pass with the message.

synchronous As Boolean

[In] Typically, you pass True for this parameter to direct the method to wait until the user interface processes the message. If you pass False, the method returns immediately without waiting for the user interface to handle the message. If you pass False and post messages faster than the user interface processes messages, the number of messages in the queue the user interface must handle grows unbounded and floods the user interface with messages, which causes the user interface to become unresponsive.


See Also

Execution

Thread

Thread.PostUIMessageEx

UIMessageCodes

WAS THIS ARTICLE HELPFUL?

Not Helpful