Méthode IOleInPlaceActiveObject ::ResizeBorder (oleidl.h)

Article
03/01/2024

Alerte l’objet dont il a besoin pour redimensionner son espace de bordure.

Syntaxe

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

Paramètres

[in] prcBorder

Pointeur vers une structure RECT contenant le nouveau rectangle externe dans lequel l’objet peut demander un espace de bordure pour ses outils.

[in] pUIWindow

Pointeur vers un pointeur d’interface IOleInPlaceUIWindow pour l’objet frame ou fenêtre de document dont la bordure a été modifiée.

[in] fFrameWindow

Ce paramètre a la valeur TRUE si l’objet de fenêtre frame appelle IOleInPlaceActiveObject ::ResizeBorder ; sinon, elle est FALSE.

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	Les valeurs de paramètre spécifiées ne sont pas valides.
E_OUTOFMEMORY	La mémoire disponible pour l’opération est insuffisante.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Remarques aux appelants

IOleInPlaceActiveObject ::ResizeBorder est appelé par l’objet de fenêtre frame ou de document du conteneur de niveau supérieur lorsque l’espace de bordure alloué à l’objet doit changer. Étant donné que l’objet actif sur place n’est pas informé de la fenêtre qui a changé (fenêtre au niveau du cadre ou du document), IOleInPlaceActiveObject ::ResizeBorder doit être passé le pointeur vers l’interface IOleInPlaceUIWindow de la fenêtre.

Remarques aux implémenteurs

Dans la plupart des cas, le redimensionnement nécessite uniquement que vous agrandissiez, réduisez ou mettez à l’échelle les ornements de cadre de votre objet. Toutefois, pour les ornements plus complexes, vous devrez peut-être renégocier l’espace de bordure avec des appels à IOleInPlaceUIWindow ::SetBorderSpace et IOleInPlaceUIWindow ::SetBorderSpace.

Note Lors de l’exécution de IOleInPlaceActiveObject ::ResizeBorder, 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 IOleInPlaceActiveObject ::ResizeBorder.

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