Méthode IDockingWindow ::ResizeBorderDW (shobjidl_core.h)

Article
03/02/2024

Avertit l’objet de fenêtre d’ancrage que l’espace de bordure du cadre a changé. En réponse à cette méthode, l’implémentation IDockingWindow doit appeler SetBorderSpaceDW, même si aucun espace de bordure n’est requis ou qu’une modification n’est pas nécessaire.

Syntaxe

HRESULT ResizeBorderDW(
  LPCRECT  prcBorder,
  IUnknown *punkToolbarSite,
  BOOL     fReserved
);

Paramètres

prcBorder

Type : LPCRECT

Pointeur vers une structure RECT qui contient l’espace de bordure disponible du cadre.

punkToolbarSite

Type : IUnknown*

Pointeur vers l’interface IUnknown du site. L’objet fenêtre d’ancrage doit appeler la méthode QueryInterface pour cette interface, en demandant IID_IDockingWindowSite. L’objet fenêtre d’ancrage utilise ensuite cette interface pour négocier son espace de bordure. Il incombe à l’objet de fenêtre d’ancrage de libérer cette interface quand elle n’est plus nécessaire.

fReserved

Type : BOOL

Réservé. Ce paramètre doit toujours être égal à zéro.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le paramètre prcBorder contient l’ensemble de l’espace de bordure disponible du cadre. L’objet de fenêtre d’ancrage doit négocier son espace de bordure, puis utiliser ces informations pour se positionner.

Par exemple, si l’objet fenêtre d’ancrage nécessite 25 pixels en haut de l’espace de bordure, il doit négocier pour cela en procédant comme suit :

Allouez une structure BORDERWIDTHS et définissez son membre supérieur sur 25.
Appelez RequestBorderSpaceDW pour demander l’espace.
Si la demande est approuvée par RequestBorderSpaceDW, appelez SetBorderSpaceDW pour allouer l’espace.

L’objet de fenêtre d’ancrage peut ensuite positionner sa fenêtre sur prcBorder-left> et prcBorder-top>. La largeur de la fenêtre de la fenêtre d’ancrage est déterminée en soustrayant prcBorder-left> de prcBorder-right>. Sa hauteur est contenue dans le membre supérieur de la structure BORDERWIDTHS .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shlobj.h)
DLL	Shell32.dll (version 4.71 ou ultérieure)

Voir aussi

Partager via