Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODCanvas

AcquireUpdateShape

The AcquireUpdateShape method returns a reference to the shape object defining the area of this canvas that needs to be updated.

ODShape AcquireUpdateShape ();

return value

A reference to the shape object defining the area of this canvas that needs to be updated.

DISCUSSION

OpenDoc calls this method internally; your part modifies the update shape of a canvas by calling its facet's Invalidate and Validate methods.

This method increments the reference count of the returned shape. When the caller has finished using that shape, it should call the shape's Release method.

SEE ALSO

The ODCanvas::Invalidate method (page 75).
The ODCanvas::ResetUpdateShape method (page 77).
The ODCanvas::Validate method (page 82).
The ODFacet::Invalidate method (page 250).
The ODFacet::Validate method (page 258).