LinkStatusChanged

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

LinkStatusChanged
The LinkStatusChanged method is called to notify this part that the link status of one of its display frames has changed.
void LinkStatusChanged (in ODFrame frame);
frame
A reference to a display frame whose link status has changed.

DISCUSSION
OpenDoc calls this method. Your part's LinkStatusChanged method should call the ChangeLinkStatus method of each embedded frame affected by the display frame change, assigning it the same link status as the display frame.
If the frame passed into the LinkStatusChanged method has been opened into a part window, the displayed part should call the ChangeLinkStatus method of the root frame of the part window. This action ensures that all frames in the part window will have their link status set correctly. Note that if a part calls the ChangeLinkStatus method of one of its display frames, OpenDoc calls the part's own LinkStatusChanged method (in this case, recursively).
If the value kODNotInLink was assigned in the ChangeLinkStatus method, then your part's LinkStatusChanged method can still get the status of this part's display frame (its containing frame).

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO
The ODFrame::ChangeLinkStatus method (page 308).
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"The LinkStatusChanged Method of Your Part Editor" on page 375 in OpenDoc Programmer's Guide.