Compartilhar via


COleControl::OnGetNaturalExtent

Chamado pela estrutura em resposta à solicitação de IViewObjectEx::GetNaturalExtent de um recipiente.

virtual BOOL OnGetNaturalExtent(
   DWORD dwAspect,
   LONG lindex,
   DVTARGETDEVICE* ptd,
   HDC hicTargetDev,
   DVEXTENTINFO* pExtentInfo,
   LPSIZEL psizel 
);

Parâmetros

  • dwAspect
    Especifica como o objeto deve ser representado.As representações incluem o conteúdo, um ícone, uma miniatura, ou um documento impresso.Os valores válidos são tirados de enumeração DVASPECT ou DVASPECT2.

  • lindex
    A parte do objeto que é de interesse.Atualmente apenas -1 é válido.

  • ptd
    Os pontos a estrutura DVTARGETDEVICE a definição do dispositivo de destino para o tamanho de objeto deve ser retornado.

  • hicTargetDev
    Especifica o contexto de informações para o dispositivo de destino indicado pelo parâmetro de ptd de que o objeto pode extrair métricas de dispositivo e testar os recursos do dispositivo.Se ptd é NULO, o objeto deve ignorar o valor do parâmetro de hicTargetDev .

  • pExtentInfo
    Pontos a estrutura de DVEXTENTINFO que especifica dados de dimensionamento.a estrutura de DVEXTENTINFO é:

    typedef struct tagExtentInfo

    {

    UINT cb;

    DWORD dwExtentMode;

    SIZEL sizelProposed;

    } DVEXTENTINFO;

    O membro de estrutura dwExtentMode pode ter um dos dois valores:

    • DVEXTENT_CONTENT inquire como grande o controle deve ser exatamente caber o conteúdo (pressão-à- o tamanho)

    • DVEXTENT_INTEGRAL para redimensionar, passe props o tamanho controlar

  • psizel
    Pontos a dados de dimensionamento retornados pelo controle.Os dados retornados de dimensionamento são definidos como -1 para qualquer dimensão que não está definida.

Valor de retorno

Diferente de zero com êxito ou retornam se ajustam o tamanho; se não 0.

Comentários

Substituir essa função para retornar o tamanho de exibição do objeto mais próximo do modo proposta de tamanho e a extensão na estrutura de DVEXTENTINFO .A implementação padrão retorna Falso e não faz nenhum ajuste o tamanho.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe de COleControl

Gráfico de hierarquia

COleControl::OnGetViewExtent