Méthode IOleInPlaceSite::GetWindowContext (oleidl.h)
Permet à un objet sur place de récupérer les interfaces de fenêtre qui forment la hiérarchie d’objets de fenêtre et la position dans la fenêtre parente où doit se trouver la fenêtre d’activation sur place de l’objet.
HRESULT GetWindowContext(
[out] IOleInPlaceFrame **ppFrame,
[out] IOleInPlaceUIWindow **ppDoc,
[out] LPRECT lprcPosRect,
[out] LPRECT lprcClipRect,
[in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);
[out] ppFrame
Pointeur vers une variable de pointeur IOleInPlaceFrame qui reçoit le pointeur d’interface vers le frame. Si une erreur se produit, l’implémentation doit définir ppFrame sur NULL.
[out] ppDoc
Pointeur vers une variable de pointeur IOleInPlaceUIWindow qui reçoit le pointeur d’interface vers la fenêtre de document. Si la fenêtre de document est identique à la fenêtre frame, ppDoc a la valeur NULL. Dans ce cas, l’objet peut uniquement utiliser ppFrame ou la négociation de bordure. Si une erreur est retournée, l’implémentation doit définir ppDoc sur NULL.
[out] lprcPosRect
Pointeur vers une structure RECT pour le rectangle contenant la position de l’objet sur place dans les coordonnées client de sa fenêtre parente. Si une erreur est retournée, ce paramètre doit être défini sur NULL.
[out] lprcClipRect
Pointeur vers une structure RECT pour le rectangle externe contenant le rectangle de position de l’objet sur place (lprcPosRect). Ce rectangle est relatif à la zone cliente de la fenêtre parente de l'objet. Si une erreur est retournée, ce paramètre doit être défini sur NULL.
[in, out] lpFrameInfo
Un pointeur vers une structure OLEINPLACEFRAMEINFO que le conteneur doit remplir avec les données appropriées. Si une erreur est retournée, ce paramètre doit être défini sur NULL.
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
Code de retour | Description |
---|---|
|
Un ou plusieurs des pointeurs fournis ne sont pas valides. |
|
Une erreur inattendue s’est produite. |
La structure OLEINPLACEFRAMEINFO fournit les données nécessaires à OLE pour distribuer les accélérateurs de frappe à un frame de conteneur pendant qu’un objet est actif sur place.
Lorsqu’un objet est activé, il appelle GetWindowContext à partir de son conteneur. Le conteneur retourne le handle à sa table d’accélérateur sur place via la structure OLEINPLACEFRAMEINFO . Avant d’appeler GetWindowContext, l’objet doit fournir la taille de la structure OLEINPLACEFRAMEINFO en remplissant le membre cb, pointé par lpFrameInfo.
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | oleidl.h |