Función SetMapMode (wingdi.h)

Artículo
03/08/2023

La función SetMapMode establece el modo de asignación del contexto de dispositivo especificado. El modo de asignación define la unidad de medida utilizada para transformar unidades de espacio de página en unidades de espacio de dispositivo y también define la orientación de los ejes x e y del dispositivo.

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] iMode

Nuevo modo de asignación. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
MM_ANISOTROPIC	Las unidades lógicas se asignan a unidades arbitrarias con ejes de escala arbitraria. Use las funciones SetWindowExtEx y SetViewportExtEx para especificar las unidades, la orientación y el escalado.
MM_HIENGLISH	Cada unidad lógica se asigna a 0,001 pulgadas. La x positiva está a la derecha, mientras que la y positiva está arriba.
MM_HIMETRIC	Cada unidad lógica se asigna a 0,01 milímetros. La x positiva está a la derecha, mientras que la y positiva está arriba.
MM_ISOTROPIC	Las unidades lógicas se asignan a unidades arbitrarias con ejes de escala igual; es decir, una unidad a lo largo del eje X es igual a una unidad a lo largo del eje Y. Use las funciones SetWindowExtEx y SetViewportEx para especificar las unidades y la orientación de los ejes. La interfaz del dispositivo gráfico (GDI) realiza ajustes según sea necesario para garantizar que las unidades x e y sigan siendo el mismo tamaño (Cuando se establece la extensión de la ventana, la ventanilla se ajustará para mantener las unidades isotrópicos).
MM_LOENGLISH	Cada unidad lógica se asigna a 0,01 pulgadas. La x positiva está a la derecha, mientras que la y positiva está arriba.
MM_LOMETRIC	Cada unidad lógica se asigna a 0,1 milímetros. La x positiva está a la derecha, mientras que la y positiva está arriba.
MM_TEXT	Cada unidad lógica se asigna a un píxel de dispositivo. La x positiva está a la derecha, mientras que la y positiva está abajo.
MM_TWIPS	Cada unidad lógica se asigna a una vigésima parte del punto de una impresora (1/1440 pulgadas, también denominada twip). La x positiva está a la derecha, mientras que la y positiva está arriba.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto identifica el modo de asignación anterior.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

El modo MM_TEXT permite que las aplicaciones funcionen en píxeles de dispositivo, cuyo tamaño varía de dispositivo a dispositivo.

Los modos MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC y MM_TWIPS son útiles para las aplicaciones que dibujan en unidades físicamente significativas (como pulgadas o milímetros).

El modo MM_ISOTROPIC garantiza una relación de aspecto de 1:1.

El modo de MM_ANISOTROPIC permite ajustar las coordenadas x e y de forma independiente.

Ejemplos

Para obtener un ejemplo, consulte Uso de espacios de coordenadas y transformaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll