Share via

Méthode IOleWindow::GetWindow (oleidl.h)

  • Article

Récupère un handle dans l’une des fenêtres participant à l’activation sur place (fenêtre frame, document, parent ou objet sur place).

Syntaxe

HRESULT GetWindow(
  [out] HWND *phwnd
);

Paramètres

[out] phwnd

Pointeur vers une variable qui reçoit le handle de fenêtre.

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_FAIL
 L’objet est sans fenêtre.
E_INVALIDARG
 La valeur fEnterMode spécifiée n’est pas valide.
E_OUTOFMEMORY
 La mémoire disponible est insuffisante pour cette opération.
E_UNEXPECTED
 Une erreur inattendue s’est produite.

Notes

Cinq types de fenêtres composent la hiérarchie des fenêtres. Lorsqu’un objet est actif sur place, il a accès à tout ou partie de ces fenêtres.

Fenêtre Description
Frame Fenêtre main la plus externe où réside le menu main de l’application conteneur.
Document Fenêtre qui affiche à l’utilisateur le document composé contenant l’objet incorporé.
Volet Sous-fenêtre de la fenêtre de document qui contient l’affichage de l’objet. Applicable uniquement aux applications avec des fenêtres fractionnées.
Parent Fenêtre de conteneur qui contient la vue de cet objet. L’application objet installe sa fenêtre en tant qu’enfant de cette fenêtre.
Sur place Fenêtre contenant l’objet actif sur place. L’application objet crée cette fenêtre et l’installe en tant qu’enfant de sa fenêtre de hache, qui est un enfant de la fenêtre parente du conteneur.
 

Chaque type de fenêtre a un rôle différent dans l’architecture d’activation sur place. Toutefois, il n’est pas nécessaire d’utiliser une fenêtre physique distincte pour chaque type. De nombreuses applications conteneur utilisent la même fenêtre pour leur frame, document, volet et fenêtre parente.

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

IOleWindow