GEOS SDK TechDocs
|
| 
4.9 Linking Views
| 
4.11 Internal Utilities
MSG_GEN_VIEW_SET_CONTENT, MSG_GEN_VIEW_GET_CONTENT
The
GVI_content
field in the
GenView instance data determines what object is designated as its content. By default, an application's Process object acts as the content. Because the output field defaults to the Process object, you do not have to explicitly set it unless you plan on using a GenContent or VisContent.
Though not usually used when the Process is the content, it is possible to change the content during execution with MSG_GEN_VIEW_SET_CONTENT . Along with this message you must pass the optr of the object that will become the new content. When the view receives this message, it will shut down the current content just as if the view were being shut down. Then it will initialize the new content as if the view were opening for the first time.
To retrieve the optr of the current content object of a view, send the view MSG_GEN_VIEW_GET_CONTENT .
void MSG_GEN_VIEW_SET_CONTENT(
optr content);
This message sets the view's
GVI_content
instance data field to a new optr. The current content will receive messages as if the view were shutting down, and the new content will receive messages as if the view were being created anew. (See The Life of a View
.)
Source: Unrestricted.
Destination: Any GenView object.
Parameters:
content
The optr of the new content object.
Return: Nothing.
Interception: Generally not intercepted.
optr MSG_GEN_VIEW_GET_CONTENT();
This message returns the optr of the object currently set as the view's content.
Source: Unrestricted.
Destination: Any GenView object.
Parameters: None.
Return: The optr currently set as the GenView's content.
Interception: Generally not intercepted.
GEOS SDK TechDocs
|
| 4.9 Linking Views
| 4.11 Internal Utilities