Metodo IViewObject2::GetExtent (oleidl.h)

Articolo
08/25/2023

Recupera le dimensioni che l'oggetto visualizzazione specificato verrà disegnato nel dispositivo di destinazione specificato.

Sintassi

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

Parametri

[in] dwDrawAspect

Visualizzazione dell'oggetto richiesta di cui interessano le dimensioni. I valori possibili vengono acquisiti dalle enumerazioni DVASPECT e 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.

[in] lindex

Parte dell'oggetto che è di interesse. Attualmente, l'unico valore possibile è -1.

[in] ptd

Puntatore alla struttura DVTARGETDEVICE che definisce il dispositivo di destinazione per il quale devono essere restituite le dimensioni dell'oggetto.

[out] lpsizel

Puntatore a dove viene restituita la dimensione 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
OLE_E_BLANK	Non è disponibile una cache appropriata.

Commenti

L'implementazione fornita da OLE di IViewObject2::GetExtent cerca la cache per le dimensioni dell'oggetto view.

Il metodo IOleObject::GetExtent nell'interfaccia IOleObject fornisce alcune delle stesse informazioni di IViewObject2::GetExtent.

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

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

Note ai chiamanti

Per impedire l'esecuzione dell'oggetto se non è già in esecuzione, è possibile chiamare IViewObject2::GetExtent anziché IOleObject::GetExtent per determinare le dimensioni della presentazione da disegnare.

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
DLL	Adhocreportingexcelclient.dll