Metodo IOleObject::GetExtent (oleidl.h)

Articolo
03/15/2023

Recupera le dimensioni correnti di visualizzazione di un oggetto in esecuzione.

Sintassi

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

Parametri

[in] dwDrawAspect

Aspetto dell'oggetto il cui limite deve essere recuperato; il valore viene ottenuto dalle enumerazioni DVASPECT e da DVASPECT2. Si noti che gli oggetti e i contenitori più recenti che supportano interfacce di disegno ottimizzate supportano i valori di enumerazione DVASPECT2 . Gli oggetti e i contenitori meno recenti che non supportano interfacce di disegno ottimizzate potrebbero non supportare DVASPECT2. Il valore più comune per questo metodo è DVASPECT_CONTENT, che specifica un rendering completo dell'oggetto all'interno del contenitore.

[out] psizel

Puntatore alla posizione in cui devono essere restituite le dimensioni dell'oggetto.

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	Il valore dwDrawAspect specificato non è valido.

Commenti

Un contenitore chiama IOleObject::GetExtent su un oggetto in esecuzione per recuperare le dimensioni di visualizzazione correnti. Se il contenitore può contenere tale dimensione, in genere lo farà perché l'oggetto, dopo tutto, sa quali dimensioni dovrebbe essere meglio del contenitore. Un contenitore esegue normalmente questa chiamata come parte dell'inizializzazione di un oggetto.

Le dimensioni di visualizzazione restituite da IOleObject::GetExtent possono differire dall'ultimo set di dimensioni impostato da IOleObject::SetExtent perché quest'ultimo metodo determina lo spazio di visualizzazione dell'oggetto al momento della chiamata del metodo, ma non modifica necessariamente le dimensioni native dell'oggetto, come determinato dall'applicazione.

Se uno dei nuovi aspetti viene richiesto in dwAspect, questo metodo può avere esito negativo o restituire lo stesso rettangolo dell'aspetto DVASPECT_CONTENT.

Nota Questo metodo deve restituire le stesse dimensioni di DVASPECT_CONTENT per tutti i nuovi aspetti in DVASPECT2. IViewObject2::GetExtent deve eseguire la stessa operazione.

Note ai chiamanti

Poiché un contenitore può effettuare questa chiamata solo a un oggetto in esecuzione, il contenitore deve invece chiamare IViewObject2::GetExtent se vuole ottenere le dimensioni di visualizzazione di un oggetto caricato dalla cache.

Note per gli implementatori

L'implementazione consiste nel riempire la struttura sizel con l'altezza e la larghezza di un oggetto.

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