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
INPLACE_E_NOTOOLSPACE
L’objet ne peut pas installer de barres d’outils dans cet objet de fenêtre.
E_OUTOFMEMORY
Mémoire insuffisante disponible pour cette opération.
E_UNEXPECTED
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

Voir aussi

IOleInPlaceUIWindow

IOleInPlaceUIWindow ::RequestBorderSpace

IOleInPlaceUIWindow ::SetBorderSpace