Programmer Guide/General Descriptions/Communication Messages - Revision history

Jw at 13:47, 14 December 2017

2017-12-14T13:47:14Z

← Older revision		Revision as of 15:47, 14 December 2017
Line 21:		Line 21:
	\|}		\|}

	The following section describes the basic shell messages (the format of a message is <code>type name id par</code>) which are returned or dispatched (passed to message handlers) by the macro <code>GetMessage</code>. For a list of ~~message~~ sent by shell items, please see the individual shell items.		The following section describes the basic shell messages (the format of a message is <code>type name id par</code>) which are returned or dispatched (passed to message handlers) by the macro <code>GetMessage</code>. For a list of messages sent by shell items, please see the individual [[Programmer_Guide/Shell_Items\|shell items]].

	Note that you can break into the debugger using the shortcut combination Ctrl+D Ctrl+D as long as the shell has either a dialog, display or a graph.Note also that if an application is a script, the shortcut Ctrl+B opens the <code>CON</code> window.		Note that you can break into the debugger using the shortcut combination Ctrl+D Ctrl+D as long as the shell has either a dialog, display or a graph.Note also that if an application is a script, the shortcut Ctrl+B opens the <code>CON</code> window.

Jw at 13:46, 14 December 2017

2017-12-14T13:46:35Z

← Older revision		Revision as of 15:46, 14 December 2017
Line 14:		Line 14:
	\|retrieves and dispatches messages		\|retrieves and dispatches messages
	\|-		\|-
	\|<code>SetMsgHandler</code>		\|<code>[[Programmer_Guide/Macro_Library/StdLib#SetMsgHandler\|SetMsgHandler]]</code>
	\|installs/uninstalls message handlers		\|installs/uninstalls message handlers
	\|-		\|-
	\|<code>PostMessage</code>		\|<code>[[Programmer_Guide/Macro_Library/StdLib#PostMessage\|PostMessage]]</code>
	\|post a message to a shell		\|post a message to a shell
	\|}		\|}

Jw at 13:45, 14 December 2017

2017-12-14T13:45:37Z

← Older revision		Revision as of 15:45, 14 December 2017
Line 11:		Line 11:
	{\|		{\|
	\|-		\|-
	\|<code>GetMessage</code>		\|<code>[[Programmer_Guide/Macro_Library/StdLib#GetMessage\|GetMessage]]</code>
	\|retrieves and dispatches messages		\|retrieves and dispatches messages
	\|-		\|-

Jw at 13:44, 14 December 2017

2017-12-14T13:44:38Z

← Older revision		Revision as of 15:44, 14 December 2017
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
			{{PG_GeneralDescriptions}}
	Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>[[Programmer_Guide/Command_Reference/MESSAGE\|MESSAGE]]</code> command.		Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>[[Programmer_Guide/Command_Reference/MESSAGE\|MESSAGE]]</code> command.

Jw at 13:44, 14 December 2017

2017-12-14T13:44:24Z

← Older revision		Revision as of 15:44, 14 December 2017
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.		Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>[[Programmer_Guide/Command_Reference/MESSAGE\|MESSAGE]]</code> command.

	STx implements basic message handling using the <code>MESSAGE</code> command. The command <code>MESSAGE LOOP</code> retrieves the earliest message from the queue or waits for a message if none is pending. The message is stored in the variable <code>#MSG</code> in the following format:		STx implements basic message handling using the <code>MESSAGE</code> command. The command <code>MESSAGE LOOP</code> retrieves the earliest message from the queue or waits for a message if none is pending. The message is stored in the variable <code>#MSG</code> in the following format:

Jw: /* Communication Messages */

2017-12-14T13:43:36Z

Communication Messages

← Older revision		Revision as of 15:43, 14 December 2017
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	~~==Communication Messages==~~

	Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.		Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.

Christian: Text replace - "S_TOOLS-STx" to "{{STX}}"

2011-04-05T15:56:38Z

Text replace - "S_TOOLS-STx" to "{{STX}}"

← Older revision		Revision as of 17:56, 5 April 2011
Line 2:		Line 2:
	==Communication Messages==		==Communication Messages==

	Messages are used in ~~S_TOOLS-STx~~ for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.		Messages are used in {{STX}} for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.

	STx implements basic message handling using the <code>MESSAGE</code> command. The command <code>MESSAGE LOOP</code> retrieves the earliest message from the queue or waits for a message if none is pending. The message is stored in the variable <code>#MSG</code> in the following format:		STx implements basic message handling using the <code>MESSAGE</code> command. The command <code>MESSAGE LOOP</code> retrieves the earliest message from the queue or waits for a message if none is pending. The message is stored in the variable <code>#MSG</code> in the following format:
Line 8:		Line 8:
	<code>#MSG = sendertype sendername messageId messageParameters</code>		<code>#MSG = sendertype sendername messageId messageParameters</code>

	In order to be able to use messages, you need to handle them. The ~~S_TOOLS-STx~~ macro library implements a set of macros to retrieve messages, install and uninstall message handlers and to send messages to other shells. If an application uses message handlers, the macro <code>GetMessage</code> must be used instead of the command <code>Message</code>. The macros are described in the Macro Library reference.		In order to be able to use messages, you need to handle them. The {{STX}} macro library implements a set of macros to retrieve messages, install and uninstall message handlers and to send messages to other shells. If an application uses message handlers, the macro <code>GetMessage</code> must be used instead of the command <code>Message</code>. The macros are described in the Macro Library reference.

	{\|		{\|

Admin: 1 revision: Initial import

2010-11-18T16:31:45Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==Communication Messages==

Messages are used in S_TOOLS-STx for many purposes, e.g. for the communication between a shell (command interpreter) and its items (graphs, dialogs, spus etc.) or for the communication and data exchange between shells. Messages are automatically sent to the owning shell by shell items on specific events. Message can also be explicitly sent by the programmer using the <code>MESSAGE</code> command.

STx implements basic message handling using the <code>MESSAGE</code> command. The command <code>MESSAGE LOOP</code> retrieves the earliest message from the queue or waits for a message if none is pending. The message is stored in the variable <code>#MSG</code> in the following format:

<code>#MSG = sendertype sendername messageId messageParameters</code>

In order to be able to use messages, you need to handle them. The S_TOOLS-STx macro library implements a set of macros to retrieve messages, install and uninstall message handlers and to send messages to other shells. If an application uses message handlers, the macro <code>GetMessage</code> must be used instead of the command <code>Message</code>. The macros are described in the Macro Library reference.

{|
|-
|<code>GetMessage</code>
|retrieves and dispatches messages
|-
|<code>SetMsgHandler</code>
|installs/uninstalls message handlers
|-
|<code>PostMessage</code>
|post a message to a shell
|}

The following section describes the basic shell messages (the format of a message is <code>type name id par</code>) which are returned or dispatched (passed to message handlers) by the macro <code>GetMessage</code>. For a list of message sent by shell items, please see the individual shell items.

Note that you can break into the debugger using the shortcut combination Ctrl+D Ctrl+D as long as the shell has either a dialog, display or a graph.Note also that if an application is a script, the shortcut Ctrl+B opens the <code>CON</code> window.