Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODWindowState

CreateFacet

The CreateFacet method creates a facet object.

ODFacet CreateFacet (in ODFrame frame, 
                     in ODShape clipShape, 
                     in ODTransform externalTransform, 
                     in ODCanvas canvas, 
                     in ODCanvas biasCanvas);

frame

A reference to the frame for the facet.

clipShape

A reference to the initial clip shape for the facet.

externalTransform

A reference to the initial external transform for the facet.

canvas

A reference to the canvas the facet should draw to, or kODNULL if identical to the canvas associated with the containing facet.

biasCanvas

A reference to the canvas object to whose coordinate space the geometry is biased, or kODNULL if the geometry is in the standard platform-normal coordinate space.

return value

A reference to the newly created facet object.

DISCUSSION

Your part calls this method to create a root facet (for example, for printing). The frame is defined for the lifetime of the facet object; once set, it cannot be changed.

To create a facet object for a visible embedded frame, your part should call its own display facet's CreateEmbeddedFacet method instead of this method.

SEE ALSO

The ODFacet::CreateEmbeddedFacet method (page 238).
The ODFacet class (page 219).
"Printing the Document" on page 181 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.