Méthode IOleWindow::GetWindow (oleidl.h)
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 |
|---|---|
|
L’objet est sans fenêtre. |
|
La valeur fEnterMode spécifiée n’est pas valide. |
|
La mémoire disponible est insuffisante pour cette opération. |
|
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 |