IOleObject interface (oleidl.h)
Serves as the principal means by which an embedded object provides basic functionality to, and communicates with, its container.
Inheritance
The IOleObject interface inherits from the IUnknown interface. IOleObject also has these types of members:
Methods
The IOleObject interface has these methods.
| IOleObject::Advise Establishes an advisory connection between a compound document object and the calling object's advise sink, through which the calling object receives notification when the compound document object is renamed, saved, or closed. |
| IOleObject::Close Changes an embedded object from the running to the loaded state. Disconnects a linked object from its link source. |
| IOleObject::DoVerb Requests that an object perform an action in response to an end-user's action. The possible actions are enumerated for the object in IOleObject::EnumVerbs. |
| IOleObject::EnumAdvise Retrieves a pointer to an enumerator that can be used to enumerate the advisory connections registered for an object, so a container can know what to release prior to closing down. |
| IOleObject::EnumVerbs Exposes a pull-down menu listing the verbs available for an object in ascending order by verb number. |
| IOleObject::GetClientSite Retrieves a pointer to an embedded object's client site. |
| IOleObject::GetClipboardData Retrieves a data object containing the current contents of the embedded object on which this method is called. Using the pointer to this data object, it is possible to create a new embedded object with the same data as the original. |
| IOleObject::GetExtent Retrieves a running object's current display size. |
| IOleObject::GetMiscStatus Retrieves the status of an object at creation and loading. |
| IOleObject::GetMoniker Retrieves an embedded object's moniker, which the caller can use to link to the object. |
| IOleObject::GetUserClassID Retrieves an object's class identifier, the CLSID corresponding to the string identifying the object to an end user. |
| IOleObject::GetUserType Retrieves the user-type name of an object for display in user-interface elements such as menus, list boxes, and dialog boxes. |
| IOleObject::InitFromData Initializes a newly created object with data from a specified data object, which can reside either in the same container or on the Clipboard. |
| IOleObject::IsUpToDate Checks whether an object is up to date. |
| IOleObject::SetClientSite Informs an embedded object of its display location, called a "client site," within its container. |
| IOleObject::SetColorScheme Specifies the color palette that the object application should use when it edits the specified object. |
| IOleObject::SetExtent Informs an object of how much display space its container has assigned it. |
| IOleObject::SetHostNames Provides an object with the names of its container application and the compound document in which it is embedded. |
| IOleObject::SetMoniker Notifies an object of its container's moniker, the object's own moniker relative to the container, or the object's full moniker. |
| IOleObject::Unadvise Deletes a previously established advisory connection. (IOleObject.Unadvise) |
| IOleObject::Update Updates an object handler's or link object's data or view caches. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | oleidl.h |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for