ChangeCanvas

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

ChangeCanvas
The ChangeCanvas method attaches a canvas to this facet.
void ChangeCanvas (in ODCanvas canvas);
canvas
A reference to a canvas to attach to this facet.

DISCUSSION
This method in turn calls its canvas's SetFacet method to ensure the canvas has a reference back to this facet. After this method executes successfully, you can display this facet and its embedded facets on the specified canvas.

Mac OS
It is the caller's responsibility to deallocate the canvas's storage when it is no longer needed.

EXCEPTIONS

kODErrCanvasHasNoOwner
The offscreen canvas has no owner.

SEE ALSO
The ODCanvas::SetFacet method (page 78).
The ODFacet::GetCanvas method (page 246).
The ODFacet::HasCanvas method (page 250).
"Adding and Removing Canvases" on page 133 in OpenDoc Programmer's Guide.
"Printing the Document" on page 174 in OpenDoc Programmer's Guide.