Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODPart

DisplayFrameRemoved

The DisplayFrameRemoved method should remove the specified frame from this part's internal list of display frames.

void DisplayFrameRemoved (in ODFrame frame);

frame

A reference to a display frame to be removed.

DISCUSSION

To permanently delete one of its embedded frames, this part's containing part calls the embedded frame's Remove method. After removing the embedded frame, OpenDoc calls this method to notify this part of the removal.

Your part's DisplayFrameRemoved method should perform any actions necessary to remove a frame. For example, it should remove any frames (and part info) embedded within the specified frame. Your part's DisplayFrameRemoved method should update your part's internal list of display frames and other related structures to reflect the removal of the specified display frame. In addition, your method should call the arbitrator's RelinquishFocusSet method to relinquish any foci owned by the display frame being removed.

By contrast, OpenDoc calls a part's DisplayFrameClosed method to clean up when the part's document or window closes.

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.

EXCEPTIONS

kODErrInvalidFrame

The specified frame is not a display frame of this part.

SEE ALSO

The ODPart::DisplayFrameClosed method (page 495).
"The DisplayFrameRemoved Method" on page 57 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Responding to a Removed Display Frame" on page 112 in OpenDoc Programmer's Guide.
"Removing an Embedded Frame" on page 121 in OpenDoc Programmer's Guide.
"Null Events" on page 194 in OpenDoc Programmer's Guide.
"Allocating Window Memory Efficiently" on page 225 in OpenDoc Programmer's Guide.