Freigeben über

IOleInPlaceUIWindow::SetBorderSpace-Methode (oleidl.h)

  • Artikel

Ordnet Speicherplatz für den Rahmen zu, der im Aufruf von IOleInPlaceUIWindow::RequestBorderSpace angefordert wurde.

Syntax

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Parameter

[in] pborderwidths

Zeiger auf eine BORDERWIDTHS-Struktur , die die angeforderte Breite der Tools in Pixel enthält. Es kann NULL sein, was angibt, dass das Objekt keinen Speicherplatz benötigt.

Rückgabewert

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

Rückgabecode Beschreibung
OLE_E_INVALIDRECT
 Das Rechteck liegt nicht innerhalb der von IOleInPlaceUIWindow::GetBorder zurückgegebenen Spezifikationen.

Hinweise

Das -Objekt muss IOleInPlaceUIWindow::SetBorderSpace aufrufen. Es kann eine der folgenden Aktionen ausführen:

  • Verwenden Sie eigene Symbolleisten, um Rahmenraum einer bestimmten Größe anzufordern.
  • Verwenden Sie keine Symbolleisten, aber erzwingen Sie, dass der Container seine Symbolleisten entfernt, indem Sie eine gültige BORDERWIDTHS-Struktur übergeben, die nichts als Nullen im pborderwidths-Parameter enthält.
  • Verwenden Sie keine Symbolleisten, aber erlauben Sie dem direkten Container, seine Symbolleisten zu verlassen, indem SIE NULL als pborderwidths-Parameter übergeben.
Die in diesem Aufruf verwendete BORDERWIDTHS-Struktur wäre in der Regel in einem vorherigen Aufruf von IOleInPlaceUIWindow::RequestBorderSpace übergeben worden, der S_OK zurückgegeben haben muss.

Wenn ein Objekt Leerzeichen auf dem Rahmen neu aushandeln muss, kann es IOleInPlaceUIWindow::SetBorderSpace erneut mit den neuen Breiten aufrufen. Wenn der Aufruf von IOleInPlaceUIWindow::SetBorderSpace fehlschlägt, kann das Objekt eine vollständige Aushandlung für den Rahmenraum mit Aufrufen von IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace und IOleInPlaceUIWindow::SetBorderSpace ausführen.

Hinweis Führen Sie beim Ausführen von IOleInPlaceUIWindow::SetBorderSpace keine Aufrufe der PeekMessage - oder GetMessage-Funktionen oder eines Dialogfelds aus. Dies kann zum Deadlock des Systems führen. Es gibt weitere Einschränkungen, für die OLE-Schnittstellenmethoden und -funktionen innerhalb von IOleInPlaceUIWindow::SetBorderSpace 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::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace