IOleInPlaceUIWindow::GetBorder-Methode (oleidl.h)

Ruft das äußere Rechteck für Symbolleisten und Steuerelemente ab, während das Objekt aktiv ist.

Syntax

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

Parameter

[out] lprectBorder

Ein Zeiger auf eine RECT-Struktur , in der das äußere Rechteck zurückgegeben werden soll. Die Koordinaten der Struktur sind relativ zum Fenster, das von der Schnittstelle dargestellt wird.

Rückgabewert

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

Rückgabecode	Beschreibung
INPLACE_E_NOTOOLSPACE	Das Objekt kann keine Symbolleisten in diesem Fensterobjekt installieren.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Hinweise für Anrufer

Die IOleInPlaceUIWindow::GetBorder-Funktion gibt beim Aufruf für ein Dokument- oder Rahmenfensterobjekt das äußere Rechteck (relativ zum Fenster) zurück, in dem das Objekt Symbolleisten oder ähnliche Steuerelemente platzieren kann.

Wenn das Objekt diese Tools installieren soll, sollte es den Speicherplatz für die Tools innerhalb dieses Rechtecks mithilfe von IOleInPlaceUIWindow::RequestBorderSpace aushandeln und dann IOleInPlaceUIWindow::SetBorderSpace aufrufen, um diesen Speicherplatz zu erhalten.

Hinweis Führen Sie beim Ausführen von IOleInPlaceUIWindow::GetBorder keine Aufrufe an die Funktionen PeekMessage oder GetMessage oder ein Dialogfeld aus. Dies kann zum Deadlock des Systems führen. Es gibt weitere Einschränkungen, bei denen OLE-Schnittstellenmethoden und -funktionen in GetBorder 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

Weitere Informationen

IOleInPlaceUIWindow

IOleInPlaceUIWindow::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace