Función SetMapMode (wingdi.h)

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

Consulte también

Funciones de espacio de coordenadas y transformación

Información general sobre espacios de coordenadas y transformaciones

GetMapMode

SetViewportExtEx

SetViewportOrgEx

SetWindowExtEx

SetWindowOrgEx