Função SetMapMode (wingdi.h)

Artigo
08/27/2023

A função SetMapMode define o modo de mapeamento do contexto de dispositivo especificado. O modo de mapeamento define a unidade de medida usada para transformar unidades de espaço de página em unidades de espaço do dispositivo e também define a orientação dos eixos x e y do dispositivo.

Sintaxe

int SetMapMode(
  [in] HDC hdc,
  [in] int iMode
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] iMode

O novo modo de mapeamento. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
MM_ANISOTROPIC	As unidades lógicas são mapeadas para unidades arbitrárias com eixos escalados arbitrariamente. Use as funções SetWindowExtExtEx e SetViewportExtExtEx para especificar as unidades, a orientação e o dimensionamento.
MM_HIENGLISH	Cada unidade lógica é mapeada para 0,001 polegada. O x positivo fica à direita; o y positivo fica para cima.
MM_HIMETRIC	Cada unidade lógica é mapeada para 0,01 milímetro. O x positivo fica à direita; o y positivo fica para cima.
MM_ISOTROPIC	As unidades lógicas são mapeadas para unidades arbitrárias com eixos igualmente dimensionados; ou seja, uma unidade ao longo do eixo x é igual a uma unidade ao longo do eixo y. Use as funções SetWindowExtExtEx e SetViewportExtExtEx para especificar as unidades e a orientação dos eixos. A GDI (interface de dispositivo gráfico) faz ajustes conforme necessário para garantir que as unidades x e y permaneçam do mesmo tamanho (quando a extensão da janela for definida, o visor será ajustado para manter as unidades isotrópicas).
MM_LOENGLISH	Cada unidade lógica é mapeada para 0,01 polegada. O x positivo fica à direita; o y positivo fica para cima.
MM_LOMETRIC	Cada unidade lógica é mapeada para 0,1 milímetro. O x positivo fica à direita; o y positivo fica para cima.
MM_TEXT	Cada unidade lógica é mapeada para um pixel de dispositivo. O x positivo fica à direita; o y positivo fica para baixo.
MM_TWIPS	Cada unidade lógica é mapeada para um vigésimo ponto de uma impressora (1/1440 polegadas, também chamada de twip). O x positivo fica à direita; o y positivo fica para cima.

Retornar valor

Se a função for bem-sucedida, o valor retornado identificará o modo de mapeamento anterior.

Se a função falhar, o valor retornado será zero.

Comentários

O modo MM_TEXT permite que os aplicativos funcionem em pixels de dispositivo, cujo tamanho varia de dispositivo para dispositivo.

Os modos MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC e MM_TWIPS são úteis para aplicativos que desenham em unidades fisicamente significativas (como polegadas ou milímetros).

O modo de MM_ISOTROPIC garante uma taxa de proporção 1:1.

O modo MM_ANISOTROPIC permite que as coordenadas x e y sejam ajustadas independentemente.

Exemplos

Para obter um exemplo, consulte Usando espaços de coordenadas e transformações.

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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll