Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODMessageInterface

CreatePartObjSpec

The CreatePartObjSpec method creates an object specifier that refers to the specified part.

void CreatePartObjSpec (out ODObjectSpec theObjSpec, 
                        in ODPart thePart);

theObjSpec

A reference to the object specifier to be set to refer to the specified part.

thePart

A reference to the part for which an object specifier is created.

DISCUSSION

If your part sends a semantic event to another part, you may use this method to address that part or to create an object specifier that represents that part. You must also call your message interface object's CreatePartAddrDesc method to create an address descriptor that identifies the OpenDoc document in which the destination part resides.

The object specifier created by this method has the type cPart and has a null container type. The object specifier allows your parts to communicate privately with each other and should not be stored persistently because it is only valid while the part is instantiated. The object specifier should also not be used in a recordable event.

EXCEPTIONS

This method may throw platform-specific exceptions.

SEE ALSO

The ODMessageInterface::CreatePartAddrDesc method (page 414).
The ODObjectSpec class (page 454).
"Using CreatePartObjSpec" on page 436 in OpenDoc Programmer's Guide.