wingdi.h


SetMapMode

La función SetMapMode asigna el modo de mapeo del contexto de dispositivo especificado. El modo de mapeo define la unidad de medida usada para transformar las unidades del espacio de página a unidades de espacio de dispositivo, y también define la orientación de los ejes x e y del dispositivo.

Sintaxis

int SetMapMode(
    HDC hdc        // manipulador de contexto de dispositivo
    int fnMapMode  // nuevo modo de mapeo
   );

Parámetros

hdc: identifica el contexto de dispositivo.

fnMapMode: especifica el nuevo modo de mapeo. Puede ser uno de los siguientes valores:

Valor Descripción
MM_ANISOTROPIC Las unidades lógicas se mapean a unidades arbitrarias con unos ejes de escala arbitrarios. Usar las funciones SetWindowExtEx y SetViewportExtEx para especificar las unidades, orientación y escala que se desee.
MM_HIENGLISH Cada unidad lógica se mapea a 0.001 pulgadas. Las x crecen a la derecha, las y hacia arriba.
MM_HIMETRIC Cada unidad lógica se mapea a 0.01 milímetros. Las x crecen a la derecha, las y hacia arriba.
MM_ISOTROPIC Las unidades lógicas se mapean a unidades arbitrarias con ejes escalados por igual; es decir, una unidad a lo largo del eje x es igual que una unidad a lo largo del eje y. Usar las funciones SetWindowExtEx y SetViewportExtEx para especificar las unidades y orientación que se prefiera para los ejes. El interfaz gráfico realiza los ajustes necesarios para asegurar que las unidades en los ejes x e y permanecen del mismo tamaño (por ejemplo, si se asigna la extensión de la ventana, el viewport será ajustado para que las unidades se mantengan isotrópicas).
MM_LOENGLISH Cada unidad lógica se mapea a 0.01 pulgadas. Las x crecen a la derecha, las y hacia arriba.
MM_LOMETRIC Cada unidad lógica se mapea a 0.1 milímetros. Las x crecen a la derecha, las y hacia arriba.
MM_TEXT Cada unidad lógica se mapea a un pixel del dispositivo. Las x crecen a la derecha, las y hacia abajo.
MM_TWIPS Cada unidad lógica se mapea a una vigésima parte de un punto de impresora (1/1440 de pulgada, también llamado "twip"). Las x crecen a la derecha, las y hacia arriba.

Valor de retorno

Si la función tiene éxito, el valor de retorno especifica el modo de mapeo previo.

Si la función falla, el valor de retorno es cero.

Observaciones

El modo MM_TEXT permite a las aplicaciones trabajar con pixeles del dispositivo, cuyo tamaño varía de un dispositivo a otro.

Los modos MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC y MM_TWIPS son corrientes para aplicaciones que trazan usando unidades físicas (tal como pulgadas o milímetros).

El modo MM_ISOTROPIC asegura una proporción de aspecto de 1:1.

El modo MM_ANISOTROPIC premite que las coordenadas x e y se puedan ajustar independientemente.