IDockingWindow::ResizeBorderDW-Methode (shobjidl_core.h)

Artikel
08/26/2023

Benachrichtigt das Andockfensterobjekt, dass sich der Rahmenbereich des Rahmens geändert hat. Als Reaktion auf diese Methode muss die IDockingWindow-Implementierung SetBorderSpaceDW aufrufen, auch wenn kein Rahmenbereich erforderlich ist oder eine Änderung nicht erforderlich ist.

Syntax

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

Parameter

prcBorder

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die den verfügbaren Rahmenbereich des Frames enthält.

punkToolbarSite

Typ: IUnknown*

Zeiger auf die IUnknown-Schnittstelle der Website. Das Andockfensterobjekt sollte die QueryInterface-Methode für diese Schnittstelle aufrufen und IID_IDockingWindowSite anfordern. Das Andockfensterobjekt verwendet dann diese Schnittstelle, um den Rahmenbereich auszuhandeln. Es liegt in der Verantwortung des Andockfensterobjekts, diese Schnittstelle freizugeben, wenn sie nicht mehr benötigt wird.

fReserved

Typ: BOOL

Reserviert. Dieser Parameter sollte immer 0 (null) sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der prcBorder-Parameter enthält den gesamten verfügbaren Rahmenbereich des Frames. Das Andockfensterobjekt sollte seinen Rahmenbereich aushandeln und dann diese Informationen verwenden, um sich selbst zu positionieren.

Wenn das Andockfensterobjekt beispielsweise 25 Pixel am oberen Rand des Rahmenbereichs benötigt, sollte es dies mithilfe der folgenden Schritte aushandeln:

Ordnen Sie eine BORDERWIDTHS-Struktur zu, und legen Sie deren oberstes Element auf 25 fest.
Rufen Sie RequestBorderSpaceDW auf, um den Speicherplatz anzufordern.
Wenn die Anforderung von RequestBorderSpaceDW genehmigt wurde, rufen Sie SetBorderSpaceDW auf, um den Speicherplatz zuzuweisen.

Das Andockfensterobjekt kann dann sein Fenster an prcBorder-left> und prcBorder-top> positionieren. Die Breite des Fensters des Andockfensters wird durch Subtrahieren von prcBorder-left> von prcBorder-right> bestimmt. Seine Höhe ist im oberen Member der BORDERWIDTHS-Struktur enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shlobj.h einschließen)
DLL	Shell32.dll (Version 4.71 oder höher)

Weitere Informationen