Méthode IOleInPlaceSite::GetWindowContext (oleidl.h)

Article
08/25/2023

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.

Syntaxe

HRESULT GetWindowContext(
  [out]     IOleInPlaceFrame      **ppFrame,
  [out]     IOleInPlaceUIWindow   **ppDoc,
  [out]     LPRECT                lprcPosRect,
  [out]     LPRECT                lprcClipRect,
  [in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);

Paramètres

[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.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs des pointeurs fournis ne sont pas valides.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Notes

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.

Spécifications


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

Voir aussi

IOleInPlaceSite

Partager via