win32.base.messages.get_message

get_message is available since version 1.0.

Prototype:

number get_message(var string Owner, var 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
[out] 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:

Gets a message from the Concept Remote Client. Messages can include property values, events fired or if MessageID is MSG_APPLICATION_MESSAGE an application message, with Sender containing the sender application APID, Target the message id, and Value the inter-application message string data. When doing this in a loop, controlled by the CApplication, you must set the ShellDebug delegate. The form is ShellDebugDelegate(Sender, Target, Value). Notice, that Target is a string (and should be evaluated, when needing a number message id).
A MessageID of 0x500 means that the application ended, and quit is requested.
Also, it has an alias named GetMessage defined in MessageDispatcher.con (you may want to include it).

This function is used by the framework, and there are easier ways to deal with messages, via the CApplication and the RemoteObject derived objects.

Return value:

Returns the size of the message.