Metodo IOleInPlaceActiveObject::ResizeBorder (oleidl.h)

Articolo
03/01/2024

Avvisa l'oggetto che deve ridimensionare lo spazio del bordo.

Sintassi

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

Parametri

[in] prcBorder

Puntatore a una struttura RECT contenente il nuovo rettangolo esterno all'interno del quale l'oggetto può richiedere spazio bordo per i relativi strumenti.

[in] pUIWindow

Puntatore a un puntatore all'interfaccia IOleInPlaceUIWindow per l'oggetto finestra cornice o documento il cui bordo è stato modificato.

[in] fFrameWindow

Questo parametro è TRUE se l'oggetto finestra cornice chiama IOleInPlaceActiveObject::ResizeBorder; in caso contrario, è FALSE.

Valore restituito

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

Codice restituito	Descrizione
E_INVALIDARG	I valori dei parametri specificati non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

Note ai chiamanti

IOleInPlaceActiveObject::ResizeBorder viene chiamato dall'oggetto finestra del documento o della cornice del contenitore di primo livello quando lo spazio del bordo allocato all'oggetto deve cambiare. Poiché l'oggetto sul posto attivo non viene informato sulla finestra modificata (finestra a livello di cornice o documento), IOleInPlaceActiveObject::ResizeBorder deve essere passato il puntatore all'interfaccia IOleInPlaceUIWindow della finestra.

Note per gli implementatori

Nella maggior parte dei casi, il ridimensionamento richiede solo l'aumento, la compattazione o la scalabilità delle decorazioni cornice dell'oggetto. Tuttavia, per le decorazioni più complesse, potrebbe essere necessario rinegoziare lo spazio dei bordi con chiamate a IOleInPlaceUIWindow::SetBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.

Nota Durante l'esecuzione di IOleInPlaceActiveObject::ResizeBorder, 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 sulle quali è possibile chiamare i metodi e le funzioni dell'interfaccia OLE dall'interno di IOleInPlaceActiveObject::ResizeBorder.

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