IOleUILinkContainer  15AANWR

The IOleUILinkContainer interface is implemented by containers and used by OLE common dialog boxes. It supports these dialog boxes by providing the methods needed to manage a container s links.

The IOleUILinkContainer methods enumerate the links associated with a container, and specify how they should be updated, automatically or manually. They change the source of a link and obtain information associated with a link. They also open a link s source document, update links, and break a link to the source.

When to Implement

You must implement this interface if you are creating a container application that will use the Links, Change Source, or Update Links dialog boxes, as well as the Object Properties dialog box, which uses this interface indirectly. The Links dialog box calls back to the container application to perform OLE functions that manipulate the links within the container.

When to Use

OLE common dialog boxes use only this interface to manage the properties of a container s links. They can also use it to manage non-OLE (DDE and other container-specific) links.

Methods in Vtable Order

IUnknown Methods

Description

QueryInterface2Y54585

Returns a pointer to a specified interface.

AddRef1SHW0SS

Increments the reference count.

ReleaseDUW01A

Decrements the reference count.

 

IOleUILinkContainer Methods

Description

GetNextLink19J900L

Enumerates the links in the container.

SetLinkUpdateOptionsH79.I

Sets update options.

GetLinkUpdateOptionsJOD5FO

Determines current update options for  the link.

SetLinkSourceAE4SMO

Changes the source of the link.

GetLinkSource6K9CFD

Returns Links dialog box information about the link.

OpenLinkSourceFOQX45

Opens a link s source.

UpdateLink11OG2MX

Forces a link to connect to its source and update.

CancelLinkLA5R4.

Disconnects selected links.

 

See Also

OleUIEditLinks, OleUIChangeSource, OleUIUpdateLinks, OleUIObjectProperties, OLEUIEDITLINKS