Metodo IOleInPlaceUIWindow::SetBorderSpace (oleidl.h)

Articolo
08/25/2023

Alloca spazio per il bordo richiesto nella chiamata a IOleInPlaceUIWindow::RequestBorderSpace.

Sintassi

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Parametri

[in] pborderwidths

Puntatore a una struttura BORDERWIDTHS contenente la larghezza richiesta degli strumenti, in pixel. Può essere NULL, a indicare che l'oggetto non necessita di spazio.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
OLE_E_INVALIDRECT	Il rettangolo non rientra nelle specifiche restituite da IOleInPlaceUIWindow::GetBorder.

Commenti

L'oggetto deve chiamare IOleInPlaceUIWindow::SetBorderSpace. Può eseguire una delle operazioni seguenti:

Utilizzare le proprie barre degli strumenti, richiedendo lo spazio bordo di una dimensione specifica.
Non usare barre degli strumenti, ma forzare il contenitore a rimuovere le relative barre degli strumenti passando una struttura BORDERWIDTHS valida contenente nulla ma zeri nel parametro pborderwidths .
Non usare barre degli strumenti, ma consentire al contenitore sul posto di lasciare le relative barre degli strumenti passando NULL come parametro pborderwidths .

La struttura BORDERWIDTHS usata in questa chiamata in genere sarebbe stata passata in una chiamata precedente a IOleInPlaceUIWindow::RequestBorderSpace, che deve essere stata restituita S_OK.

Se un oggetto deve rinegoziare lo spazio sul bordo, può chiamare nuovamente IOleInPlaceUIWindow::SetBorderSpace con le nuove larghezze. Se la chiamata a IOleInPlaceUIWindow::SetBorderSpace ha esito negativo, l'oggetto può eseguire una negoziazione completa per lo spazio di bordo con chiamate a IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.

Nota Durante l'esecuzione di IOleInPlaceUIWindow::SetBorderSpace, non effettuare chiamate alle funzioni PeekMessage o GetMessage o a una finestra di dialogo. In questo modo il sistema potrebbe causare un deadlock. Esistono ulteriori restrizioni per cui è possibile chiamare i metodi e le funzioni dell'interfaccia OLE dall'interno di IOleInPlaceUIWindow::SetBorderSpace.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h

Vedi anche

Ioleinplaceuiwindow

IOleInPlaceUIWindow::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace

Condividi tramite