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.