Méthode IOleInPlaceUIWindow ::GetBorder (oleidl.h)
Récupère le rectangle externe pour les barres d’outils et les contrôles lorsque l’objet est actif sur place.
Syntaxe
HRESULT GetBorder(
[out] LPRECT lprectBorder
);
Paramètres
[out] lprectBorder
Pointeur vers une structure RECT où le rectangle externe doit être retourné. Les coordonnées de la structure sont relatives à la fenêtre représentée par l’interface.
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 ne peut pas installer de barres d’outils dans cet objet de fenêtre. |
|
Mémoire insuffisante disponible pour cette opération. |
|
Une erreur inattendue s’est produite. |
Remarques
Remarques aux appelants
La fonction IOleInPlaceUIWindow ::GetBorder , lorsqu’elle est appelée sur un objet de fenêtre de document ou de cadre, retourne le rectangle externe (relatif à la fenêtre) dans lequel l’objet peut placer des barres d’outils ou des contrôles similaires.Si l’objet doit installer ces outils, il doit négocier l’espace des outils dans ce rectangle à l’aide de IOleInPlaceUIWindow ::RequestBorderSpace , puis appeler IOleInPlaceUIWindow ::SetBorderSpace pour obtenir cet espace alloué.
Note Lors de l’exécution de IOleInPlaceUIWindow ::GetBorder, n’effectuez pas d’appels aux fonctions PeekMessage ou GetMessage ou à une boîte de dialogue. Cela peut entraîner l’interblocage du système. Il existe d’autres restrictions quant aux méthodes et fonctions d’interface OLE qui peuvent être appelées à partir de GetBorder.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |