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 |
---|---|
|
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. |
|
Cada unidad lógica se asigna a 0,001 pulgadas. La x positiva está a la derecha, mientras que la y positiva está arriba. |
|
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. |
|
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). |
|
Cada unidad lógica se asigna a 0,01 pulgadas. La x positiva está a la derecha, mientras que la y positiva está arriba. |
|
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. |
|
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. |
|
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