ViewerPostMessage

Posts a Windows System Message to the specified project screen.

Function Group Execution Windows Embedded Thin Client
ViewerPostMessage Module Activity Asynchronous Supported Supported Supported
Note: This function cannot be used with Tasks or in the Global Procedures script.

Syntax

ViewerPostMessage( strScrTitle, numMessage, numwParam, numlParam, optNumID )
strScrTitle
The name of the screen to which the message will be posted.
numMessage
The number of the Windows System Message to be posted.
numwParam
A numeric value or tag; additional message-specific information, which is passed to wParam of the Windows System Message.
numlParam
A numeric value or tag; additional message-specific information, which is passed to lParam of the Windows System Message.
optNumID
The specific instance number of the screen. (The ID is assigned when the screen is opened with the Open() function.) This is an optional parameter; the default ID is 0.

Returned value

This function returns no values.

Notes

This function emulates the PostMessage function in Microsoft Windows. For more information, including a complete list of available Windows System Messages, please consult Microsoft Developers Network.

Examples

Tag Name Expression
  ViewerPostMessage( "main", 16, 3, 1, 10 )

// Sends message 16 to the "main" screen with ID 10.