Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDraft

CreateLinkSource

The CreateLinkSource method creates a new link-source object in this draft.

ODLinkSource CreateLinkSource (in ODPart part);

part

A reference to the part containing the source content of the link.

return value

A reference to the newly created link-source object.

DISCUSSION

You typically call this method from your part's CreateLink method when creating the source of a link. You can call this method only if this draft's current permissions provide write access.

Because all link-source objects have a unique link object companion, this method fails if the companion object cannot be created.

This method initializes the reference count of the returned link-source object. When you have finished using that link-source object, you should call its Release method.

If this method executes successfully, it marks this draft as dirty.

EXCEPTIONS

kODErrCannotCreateLink

Cannot create the link-source object or the companion link object.

SEE ALSO

The ODDraft::AcquireLinkSource method (page 155).
The ODPart::CreateLink method (page 492).
The ODLinkSource class (page 371).
"Creating a Link at the Source" on page 386 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.