8.3 Messages Received

This section describes the messages which TOPCAT will respond to when it receives them from other applications via the PLASTIC hub. The PLASTIC message IDs are listed along with the descriptions; unless you are a tool developer you can probably ignore these.

Load Table
Loads a table broadcast by another application. It is added to the list of tables in the Control Window.

Message ID: ivo://votech.org/votable/load or ivo://votech.org/votable/loadFromURL

New Subset
If TOPCAT already has loaded the table identified by the request, it will select the received Row Subset as the currently selected one. This has the effect of setting it as the only displayed subset in any open plot windows, as well as changing the current state of the Apparent Table. Unless the received subset is exactly the same as one already defined for that table, a new subset with a name like "plastic-1" will be added to the table's list of subsets for this purpose.

Message ID: ivo://votech.org/votable/showObjects

Highlight Row
If TOPCAT already has loaded the table identified by the request, it will activate the requested row. This will result in the row being marked in any currently visible plots and in the Data Window if it is visible, as well as performing any additional actions you have configured in the Activation Window.

Message ID: ivo://votech.org/votable/highlightObject

The following system-level messages are also responded to: