win32.base.messages.wait_message_ID

wait_message_ID is available since version 1.0.

Prototype:

number wait_message_ID(var string Owner, string MessageID, var string Target, var string Value)

Parameters

Owner
[out] a string describing the Owner parameter for a Concept Client. Usualy, this is the RID of the calling control, but may have other values.
MessageID
[in] the Concept Client API message ID
Target
[out] the message target. For example, when getting a property, this is the property id.
Value
[out] the value of the message. For example, when getting a property, this is the property value.

Description:

Similar to get_message, with the difference that it waits for a specific message ID given by the caller.

This function is used by the framework, and there are easier ways to deal with messages, via the CApplication and the RemoteObject derived objects. Any messages that have not the MessageID will be added in a buffer, that will be processed later by the get_message function.

Return value:

Returns the size in bytes of the received message.