Функция SetMapMode (wingdi.h)

  • Статья

Функция SetMapMode задает режим сопоставления указанного контекста устройства. Режим сопоставления определяет единицу измерения, используемую для преобразования единиц пространства страницы в единицы пространства устройства, а также определяет ориентацию осей x и y устройства.

Синтаксис

int SetMapMode(
  [in] HDC hdc,
  [in] int iMode
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] iMode

Новый режим сопоставления. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
MM_ANISOTROPIC
 Логические единицы сопоставляются с произвольными единицами с произвольно масштабируемыми осями. Используйте функции SetWindowExtEx иSetViewportExtEx, чтобы указать единицы измерения, ориентацию и масштабирование.
MM_HIENGLISH
 Каждая логическая единица сопоставляется с размером 0,001 дюйма. Положительный x — справа; положительный y работает.
MM_HIMETRIC
 Каждая логическая единица сопоставляется с 0,01 миллиметра. Положительный x — справа; положительный y работает.
MM_ISOTROPIC
 Логические единицы сопоставляются с произвольными единицами с одинаково масштабируемыми осями; то есть одна единица вдоль оси X равна одной единице вдоль оси Y. Используйте функции SetWindowExtEx и SetViewportExtEx, чтобы указать единицы измерения и ориентацию осей. Интерфейс графического устройства (GDI) вносит необходимые корректировки, чтобы обеспечить одинаковый размер единиц x и y (если задан экстент окна, окно просмотра будет скорректировано таким образом, чтобы единицы измерения оставались изотропными).
MM_LOENGLISH
 Каждая логическая единица сопоставляется с размером 0,01 дюйма. Положительный x — справа; положительный y работает.
MM_LOMETRIC
 Каждая логическая единица сопоставляется с 0,1 миллиметра. Положительный x — справа; положительный y работает.
MM_TEXT
 Каждая логическая единица сопоставляется с одним пикселем устройства. Положительный x — справа; положительный y не работает.
MM_TWIPS
 Каждая логическая единица сопоставляется с одной двадцатой точки принтера (1/1440 дюйма, также называемой twip). Положительный x — справа; положительный y работает.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение определяет предыдущий режим сопоставления.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Режим MM_TEXT позволяет приложениям работать в пикселях устройства, размер которых зависит от устройства.

Режимы MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC и MM_TWIPS полезны для приложений в физически значимых единицах (например, дюймах или миллиметрах).

Режим MM_ISOTROPIC обеспечивает пропорции 1:1.

Режим MM_ANISOTROPIC позволяет корректировать координаты X и Y независимо.

Примеры

Пример см. в разделе Использование координатных пространств и преобразований.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

Функции координатного пространства и преобразования

Общие сведения о координатных пространствах и преобразованиях

GetMapMode

SetViewportExtEx

SetViewportOrgEx

SetWindowExtEx

SetWindowOrgEx