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

Artigo
03/01/2024

Recupera o tamanho de exibição atual de um objeto em execução.

Sintaxe

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

Parâmetros

[in] dwDrawAspect

O aspecto do objeto cujo limite deve ser recuperado; o valor é obtido das enumerações DVASPECT e de 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. O valor mais comum para esse método é DVASPECT_CONTENT, que especifica uma renderização completa do objeto dentro de seu contêiner.

[out] psizel

Ponteiro para onde o tamanho do objeto deve ser 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
E_INVALIDARG	O valor dwDrawAspect fornecido é inválido.

Comentários

Um contêiner chama IOleObject::GetExtent em um objeto em execução para recuperar seu tamanho de exibição atual. Se o contêiner puder acomodar esse tamanho, ele normalmente o fará porque o objeto, afinal, sabe qual tamanho ele deve ser melhor do que o contêiner. Normalmente, um contêiner faz essa chamada como parte da inicialização de um objeto.

O tamanho de exibição retornado por IOleObject::GetExtent pode ser diferente do tamanho definido pela última vez por IOleObject::SetExtent porque o último método determina o espaço de exibição do objeto no momento em que o método é chamado, mas não altera necessariamente o tamanho nativo do objeto, conforme determinado por seu aplicativo.

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

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

Anotações para chamadores

Como um contêiner pode fazer essa chamada apenas para um objeto em execução, o contêiner deve chamar IViewObject2::GetExtent se quiser obter o tamanho de exibição de um objeto carregado de seu cache.

Anotações aos implementadores

A implementação consiste em preencher a estrutura sizel com a altura e a largura de um objeto.

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