COleControl::OnGetNaturalExtent

Artigo
08/25/2010

Chamado pela estrutura em resposta a IViewObjectEx::GetNaturalExtent solicitação.

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.Representações em forma de incluem conteúdo, um ícone, uma miniatura ou um documento impresso.Os valores válido são tirados de enumeração DVASPECT or DVASPECT2.
Lindex
Parte do objeto de seu interesse.Currently only -1 is valid.
ptd
Aponta para o DVTARGETDEVICE estrutura definindo o dispositivo de destino para o qual o dimensionar do objeto deve ser retornado.
hicTargetDev
Especifica o contexto de informações para o dispositivo de destino indicado pelo ptd parâmetro do qual o objeto pode extrair métricas de dispositivo e testar os recursos do dispositivo. If ptd é NULO, o objeto deve ignorar o valor de hicTargetDev parâmetro.
pExtentInfo
Aponta para o DVEXTENTINFO estrutura que especifica os dados de dimensionamento.The DVEXTENTINFO estrutura é:

typedef struct tagExtentInfo

{

UINT cb;

DWORD dwExtentMode;

SIZEL sizelProposed;

} DVEXTENTINFO;

A estrutura membro dwExtentMode pode ter um dos dois valores:
- DVEXTENT_CONTENT Consultar o dimensionar máximo que o controle deve ser caber exatamente conteúdo (snap para dimensionar)
- DVEXTENT_INTEGRAL Ao redimensionar, passar dimensionar proposto para controle
psizel
Pontos de dados retornados pelo controle de dimensionamento.Os dados retornados de dimensionamento são definidos como -1 para qualquer dimensão não foi ajustado.

Valor de retorno

Diferente de zero se retorna com êxito ou ajusta o dimensionar; caso contrário, 0.

Comentários

Substituir esta função para retornar o dimensionar da exibição do objeto mais próximo o modo de dimensionar e a extensão proposto no DVEXTENTINFO estrutura.A implementação padrão retorna FALSE e faz com que não há ajustes no dimensionar.