UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:wingdi.GetMapMode

GetMapMode function (wingdi.h)

The GetMapMode function retrieves the current mapping mode.

GetMapMode

GetMapMode function [Windows GDI]

_win32_GetMapMode

gdi.getmapmode

wingdi/GetMapMode

gdi\getmapmode.htm

gdi

bc446b86-3dde-4460-bc54-1eaa4ad19941

12/05/2018

GetMapMode, GetMapMode function [Windows GDI], _win32_GetMapMode, gdi.getmapmode, wingdi/GetMapMode

wingdi.h

Windows.h

Windows

Windows 2000 Professional [desktop apps only]

Windows 2000 Server [desktop apps only]

Gdi32.lib

Gdi32.dll

Windows

19H1

GetMapMode

wingdi/GetMapMode

c++

APIRef

kbSyntax

DllExport

gdi32.dll

Ext-MS-Win-GDI-Draw-l1-1-1.dll

ext-ms-win-gdi-draw-l1-1-2.dll

Ext-MS-Win-GDI-Draw-L1-1-3.dll

GDI32Full.dll

GetMapMode

GetMapMode function

-description

The GetMapMode function retrieves the current mapping mode.

-parameters

-param hdc [in]

A handle to the device context.

-returns

If the function succeeds, the return value specifies the mapping mode.

If the function fails, the return value is zero.

-remarks

The following are the various mapping modes.

Mode	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 required.
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.