The GetMapMode function retrieves the current mapping mode.
int GetMapMode(
HDC hdc // handle of device context
);
If the function succeeds, the return value specifies the mapping mode.
If the function fails, the return value is zero.
Windows NT: To get extended error information, call GetLastError.
The following list describes the various mapping modes:
Value | Description |
---|---|
MM_ANISOTROPIC | Logical units are mapped to arbitrary units with arbitrarily scaled axes. Use the SetWindowExtEx and SetViewportExtEx functions to specify the units, orientation, and scaling requiredt. |
MM_HIENGLISH | Each logical unit is mapped to 0.001 inch. Positive x is to the right; positive y is up. |
MM_HIMETRIC | Each logical unit is mapped to 0.01 millimeter. Positive x is to the right; positive y is up. |
MM_ISOTROPIC | Logical units are mapped to arbitrary units with equally scaled axes; that is, one unit along the x-axis is equal to one unit along the y-axis. Use the SetWindowExtEx and SetViewportExtEx functions to specify the units and the orientation of the axes. Graphics device interface makes adjustments as necessary to ensure the x and y units remain the same size. (When the windows extent is set, the viewport will be adjusted to keep the units isotropic). |
MM_LOENGLISH | Each logical unit is mapped to 0.01 inch. Positive x is to the right; positive y is up. |
MM_LOMETRIC | Each logical unit is mapped to 0.1 millimeter. Positive x is to the right; positive y is up. |
MM_TEXT | Each logical unit is mapped to one device pixel. Positive x is to the right; positive y is down. |
MM_TWIPS | Each logical unit is mapped to one twentieth of a printer's point (1/1440 inch, also called a "twip"). Positive x is to the right; positive y is up. |
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Coordinate Spaces and Transformations Overview, Coordinate Space and Transformation Functions, SetMapMode, SetWindowExtEx, SetViewportExtEx