IOleInPlaceActiveObject::ResizeBorder-Methode (oleidl.h)

Artikel
08/25/2023

Benachrichtigt das Objekt, dass es die Größe des Rahmenbereichs ändern muss.

Syntax

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

Parameter

[in] prcBorder

Ein Zeiger auf eine RECT-Struktur , die das neue äußere Rechteck enthält, in dem das Objekt Rahmenbereich für seine Tools anfordern kann.

[in] pUIWindow

Ein Zeiger auf einen IOleInPlaceUIWindow-Schnittstellenzeiger für das Frame- oder Dokumentfensterobjekt, dessen Rahmen sich geändert hat.

[in] fFrameWindow

Dieser Parameter ist TRUE , wenn das Framefensterobjekt IOleInPlaceActiveObject::ResizeBorder aufruft. Andernfalls ist es FALSE.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_INVALIDARG	Die angegebenen Parameterwerte sind ungültig.
E_OUTOFMEMORY	Für den Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Hinweise für Anrufer

IOleInPlaceActiveObject::ResizeBorder wird vom Dokument- oder Framefensterobjekt des Containers der obersten Ebene aufgerufen, wenn sich der dem Objekt zugeordnete Rahmenbereich ändern soll. Da das aktive direkte Objekt nicht darüber informiert wird, welches Fenster geändert wurde (das Fenster auf Frame- oder Dokumentebene), muss IOleInPlaceActiveObject::ResizeBorder der Zeiger auf die IOleInPlaceUIWindow-Schnittstelle des Fensters übergeben werden.

Hinweise für Implementierer

In den meisten Fällen erfordert das Ändern der Größe nur, dass Sie die Rahmenverzierungen Ihres Objekts vergrößern, verkleinern oder skalieren. Bei komplizierteren Verzierungen ist es jedoch möglicherweise erforderlich, den Rahmenbereich mit Aufrufen von IOleInPlaceUIWindow::SetBorderSpace und IOleInPlaceUIWindow::SetBorderSpace neu auszuhandeln.

Hinweis Führen Sie beim Ausführen von IOleInPlaceActiveObject::ResizeBorder keine Aufrufe an die Funktionen PeekMessage , GetMessage oder ein Dialogfeld aus. Dies kann zu einem Deadlock des Systems führen. Es gibt weitere Einschränkungen, welche OLE-Schnittstellenmethoden und -Funktionen innerhalb von IOleInPlaceActiveObject::ResizeBorder aufgerufen werden können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h