|
IOleInPlaceSite::GetWindowContext
Enables the in-place object to retrieve the window interfaces that form the
window object hierarchy, and the position in the parent window where the object's
in-place activation window should be placed.
HRESULT GetWindowContext(
IOleInPlaceFrame **ppFrame,
| //Location to return frame interface pointer
| IOleInPlaceUIWindow **ppDoc,
| //Location to return document window pointer
| LPRECT lprcPosRect,
| //Points to position of in-place object
| LPRECT lprcClipRect,
| //Points to in-place object's position rectangle
| LPOLEINPLACEFRAMEINFO lpFrameInfo
| //Points to OLEINPLACEFRAMEINFO structure
| );
|
|
Parameters
ppFrame
[out] Points to where the pointer to the frame interface is to be returned. If
an error is returned, this parameter must be set to NULL.
ppDoc
[out] Points to where the pointer to the document window interface is to be
returned. NULL is returned through the ppDoc pointer if the document window is the same as the frame window. In this case,
the object can only use ppFrame or border negotiation. If an error is returned, this parameter must be set to
NULL.
lprcPosRect
[out] Points to the rectangle containing the position of the in-place object
in the client coordinates of its parent window. If an error is returned, this
parameter must be set to NULL.
lprcClipRect
[out] Points to the outer rectangle containing the in-place object's position
rectangle (PosRect). This rectangle is relative to the client area of the object's parent
window. If an error is returned, this parameter must be set to NULL.
lpFrameInfo
[out] Points to an OLEINPLACEFRAMEINFO structure the container is to fill in with appropriate data. If an error is
returned, this parameter must be set to NULL.
Return Values
S_OK
The method completed successfully.
E_INVALIDARG
One or more arguments are invalid (for example, an invalid pointer or
parameter).
E_UNEXPECTED
An unexpected error occurred.
Comments
The OLEINPLACEFRAMEINFO structure provides data needed by OLE to dispatch keystroke accelerators to a
container frame while an object is active in place.
When an object is activated, it calls GetWindowContext from its container. The container returns the handle to its in-place
accelerator table through the OLEINPLACEFRAMEINFO structure. Before calling GetWindowContext, the object must provide the size of the OLEINPLACEFRAMEINFO structure by filling in the cb member, pointed to by lpFrameInfo.
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
