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

Artigo
03/01/2024

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.

Código de retorno	Descrição
OLE_E_BLANK	Um cache apropriado não está disponível.

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

Para impedir que o objeto seja executado se ele ainda não estiver em execução, você pode chamar IViewObject2::GetExtent em vez de IOleObject::GetExtent para determinar o tamanho da apresentação a ser desenhada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h
DLL	Adhocreportingexcelclient.dll