IOleUILinkContainer
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 |
QueryInterface |
Returns a
pointer to a specified interface. |
AddRef |
Increments
the reference count. |
Release |
Decrements
the reference count. |
IOleUILinkContainer
Methods |
Description |
GetNextLink |
Enumerates
the links in the container. |
SetLinkUpdateOptions |
Sets update
options. |
GetLinkUpdateOptions |
Determines
current update options for the link. |
SetLinkSource |
Changes the
source of the link. |
GetLinkSource |
Returns
Links dialog box information about the link. |
OpenLinkSource |
Opens a
link s source. |
UpdateLink |
Forces a
link to connect to its source and update. |
CancelLink |
Disconnects
selected links. |
See Also