Método IViewObject2::GetExtent (oleidl.h)

Recupera o tamanho que o objeto de exibição especificado será desenhado no dispositivo de destino especificado.

Sintaxe

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

Parâmetros

[in] dwDrawAspect

Exibição solicitada do objeto cujo tamanho é de interesse. Os valores possíveis são obtidos das enumerações DVASPECT e DVASPECT2 . Observe que objetos e contêineres mais recentes que dão suporte a interfaces de desenho otimizadas dão suporte aos valores de enumeração DVASPECT2 . Objetos e contêineres mais antigos que não dão suporte a interfaces de desenho otimizadas podem não dar suporte a DVASPECT2.

[in] lindex

A parte do objeto que é de interesse. Atualmente, o único valor possível é -1.

[in] ptd

Um ponteiro para a estrutura DVTARGETDEVICE definindo o dispositivo de destino para o qual o tamanho do objeto deve ser retornado.

[out] lpsizel

Um ponteiro para onde o tamanho do objeto é retornado.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Comentários

A implementação fornecida por OLE de IViewObject2::GetExtent pesquisa no cache o tamanho do objeto de exibição.

O método IOleObject::GetExtent na interface IOleObject fornece algumas das mesmas informações que IViewObject2::GetExtent.

Esse método deve retornar o mesmo tamanho que DVASPECT_CONTENT para todos os novos aspectos em DVASPECT2. IOleObject::GetExtent deve fazer a mesma coisa.

Se um dos novos aspectos for solicitado no dwAspect, esse método poderá falhar ou retornar o mesmo retângulo do aspecto DVASPECT_CONTENT.

Anotações para chamadores

Requisitos

Confira também

DVASPECT

DVASPECT2

IOleObject::GetExtent

Iviewobject

IViewObject2