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 |
|---|---|
|
Das Objekt kann keine Symbolleisten in diesem Fensterobjekt installieren. |
|
Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar. |
|
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 |