Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IOleClientSite::ShowObject method

Asks a container to display its object to the user. This method ensures that the container itself is visible and not minimized.

Syntax


HRESULT ShowObject();

Parameters

This method has no parameters.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
OLE_E_NOT_SUPPORTED

Client site is in an OLE 1 container.

 

Remarks

After a link client binds to a link source, it commonly calls IOleObject::DoVerb on the link source, usually requesting the source to perform some action requiring that it display itself to the user. As part of its implementation of IOleObject::DoVerb, the link source can call ShowObject, which forces the client to show the link source as best it can. If the link source's container is itself an embedded object, it will recursively invoke ShowObject on its own container.

Having called the ShowObject method, a link source has no guarantee of being appropriately displayed because its container may not be able to do so at the time of the call. The ShowObject method does not guarantee visibility, only that the container will do the best it can.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleClientSite is defined as 00000118-0000-0000-C000-000000000046

See also

IOleClientSite
IOleObject::DoVerb

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.