Partilhar via


CDC::SetMapMode

Defina o modo de mapeamento.

virtual int SetMapMode( 
   int nMapMode  
);

Parâmetros

  • nMapMode
    Especifica o novo modo de mapeamento. Pode ser qualquer um dos seguintes valores:

    • As unidades lógicas deMM_ANISOTROPIC são convertidas em unidades arbitrárias com eixos arbitrariamente redimensionados. Definir o modo de mapeamento a MM_ANISOTROPIC não modifica as configurações atuais da janela ou do viewport. Para alterar as unidades, a orientação, e redimensionar, chamam funções de membro de SetWindowExt e de SetViewportExt .

    • MM_HIENGLISH cada unidade lógica é convertido para 0,001 polegadas. X positivo é à direita; y positivo está acima.

    • MM_HIMETRIC cada unidade lógica é convertido para 0,01 mm. X positivo é à direita; y positivo está acima.

    • As unidades lógicas deMM_ISOTROPIC são convertidas em unidades arbitrárias com eixos igualmente; dimensionados isto é, unidade 1 no eixo x é igual a 1 unidade no eixo y. Use as funções de membro de SetWindowExt e de SetViewportExt para especificar as unidades desejadas e orientação dos eixos. GDI faz ajustes conforme necessário para garantir que as unidades x e y permaneçam o mesmo tamanho.

    • MM_LOENGLISH cada unidade lógica é convertido para 0,01 polegadas. X positivo é à direita; y positivo está acima.

    • MM_LOMETRIC cada unidade lógica é convertido para 0,1 mm. X positivo é à direita; y positivo está acima.

    • MM_TEXT cada unidade lógica é convertido para 1 pixel de dispositivo. X positivo é à direita; y positivo está pressionada.

    • MM_TWIPS cada unidade lógica é convertido em 1/20 de um ponto. (Como um ponto está 1/72 de polegada, um twip é 1/1440 de polegada.) X positivo é à direita; y positivo está acima.

Valor de retorno

O modo anterior do mapeamento.

Comentários

O modo de mapeamento define a unidade de medida usada para converter unidades lógicas as unidades de dispositivo; também define a orientação de x do dispositivo e o eixo y. GDI usa o modo de mapeamento para converter coordenadas lógicas em coordenadas de dispositivo apropriadas. O modo de MM_TEXT permite que aplicativos trabalhar em pixels de dispositivo, onde 1 unidade é igual a 1 pixel. Físico o tamanho de um pixel varia de dispositivo para o dispositivo.

MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC, e os modos de MM_TWIPS são úteis para aplicativos que devem desenhar em unidades fisicamente significativos (como polegadas ou mm). O modo de MM_ISOTROPIC garante um extensor de 1:1, que é útil quando é importante preservar a forma exata de uma imagem. O modo de MM_ANISOTROPIC permite as coordenadas x e y a ser definidos independente.

Dica

Se você chamar SetLayout para alterar o DC (contexto de dispositivo) para o layout da direita para a esquerda, SetLayout altera automaticamente o modo de mapeamento a MM_ISOTROPIC.

Exemplo

Consulte o exemplo para CView::OnPrepareDC.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia

CDC::SetViewportExt

CDC::SetWindowExt

SetMapMode