Metodo IOleInPlaceUIWindow::GetBorder (oleidl.h)

Recupera il rettangolo esterno per le barre degli strumenti e i controlli mentre l'oggetto è attivo sul posto.

Sintassi

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

Parametri

[out] lprectBorder

Puntatore a una struttura RECT in cui deve essere restituito il rettangolo esterno. Le coordinate della struttura sono relative alla finestra rappresentata dall'interfaccia.

Valore restituito

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

Codice restituito	Descrizione
INPLACE_E_NOTOOLSPACE	L'oggetto non può installare barre degli strumenti in questo oggetto finestra.
E_OUTOFMEMORY	Memoria insufficiente disponibile per questa operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

Note ai chiamanti

La funzione IOleInPlaceUIWindow::GetBorder , quando viene chiamata su un oggetto finestra documento o frame, restituisce il rettangolo esterno (relativo alla finestra) in cui l'oggetto può inserire barre degli strumenti o controlli simili.

Se l'oggetto consiste nell'installare questi strumenti, deve negoziare lo spazio per gli strumenti all'interno di questo rettangolo usando IOleInPlaceUIWindow::RequestBorderSpace e quindi chiamare IOleInPlaceUIWindow::SetBorderSpace per ottenere questo spazio allocato.

Nota Durante l'esecuzione di IOleInPlaceUIWindow::GetBorder, non effettuare chiamate alle funzioni PeekMessage o GetMessage o a una finestra di dialogo. In questo modo può causare il deadlock del sistema. Esistono ulteriori restrizioni per cui è possibile chiamare metodi e funzioni dell'interfaccia OLE all'interno di GetBorder.

 

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::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace