Méthode IOleInPlaceUIWindow ::SetBorderSpace (oleidl.h)

Alloue de l’espace pour la bordure demandée dans l’appel à IOleInPlaceUIWindow ::RequestBorderSpace.

Syntaxe

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Paramètres

[in] pborderwidths

Pointeur vers une structure BORDERWIDTHS contenant la largeur demandée des outils, en pixels. Il peut être NULL, ce qui indique que l’objet n’a pas besoin d’espace.

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
OLE_E_INVALIDRECT
Le rectangle ne se trouve pas dans les spécifications retournées par IOleInPlaceUIWindow ::GetBorder.

Remarques

L’objet doit appeler IOleInPlaceUIWindow ::SetBorderSpace. Il peut effectuer l’une des opérations suivantes :

  • Utilisez ses propres barres d’outils, en demandant un espace de bordure d’une taille spécifique.
  • N’utilisez aucune barre d’outils, mais forcez le conteneur à supprimer ses barres d’outils en transmettant une structure BORDERWIDTHS valide ne contenant que des zéros dans le paramètre pborderwidths .
  • N’utilisez aucune barre d’outils, mais autorisez le conteneur sur place à conserver ses barres d’outils en transmettant NULL comme paramètre pborderwidths .
La structure BORDERWIDTHS utilisée dans cet appel aurait généralement été passée lors d’un appel précédent à IOleInPlaceUIWindow ::RequestBorderSpace, qui doit avoir retourné S_OK.

Si un objet doit renégocier l’espace sur la bordure, il peut appeler À nouveau IOleInPlaceUIWindow ::SetBorderSpace avec les nouvelles largeurs. Si l’appel à IOleInPlaceUIWindow ::SetBorderSpace échoue, l’objet peut effectuer une négociation complète pour l’espace de bordure avec des appels à IOleInPlaceUIWindow ::GetBorder, IOleInPlaceUIWindow ::RequestBorderSpace et IOleInPlaceUIWindow ::SetBorderSpace.

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

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 ::GetBorder

IOleInPlaceUIWindow ::RequestBorderSpace