Функция SetMapMode (wingdi.h)
Функция SetMapMode задает режим сопоставления указанного контекста устройства. Режим сопоставления определяет единицу измерения, используемую для преобразования единиц пространства страницы в единицы пространства устройства, а также определяет ориентацию осей x и y устройства.
Синтаксис
int SetMapMode(
[in] HDC hdc,
[in] int iMode
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] iMode
Новый режим сопоставления. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Логические единицы сопоставляются с произвольными единицами с произвольно масштабируемыми осями. Используйте функции SetWindowExtEx иSetViewportExtEx, чтобы указать единицы измерения, ориентацию и масштабирование. |
|
Каждая логическая единица сопоставляется с размером 0,001 дюйма. Положительный x — справа; положительный y работает. |
|
Каждая логическая единица сопоставляется с 0,01 миллиметра. Положительный x — справа; положительный y работает. |
|
Логические единицы сопоставляются с произвольными единицами с одинаково масштабируемыми осями; то есть одна единица вдоль оси X равна одной единице вдоль оси Y. Используйте функции SetWindowExtEx и SetViewportExtEx, чтобы указать единицы измерения и ориентацию осей. Интерфейс графического устройства (GDI) вносит необходимые корректировки, чтобы обеспечить одинаковый размер единиц x и y (если задан экстент окна, окно просмотра будет скорректировано таким образом, чтобы единицы измерения оставались изотропными). |
|
Каждая логическая единица сопоставляется с размером 0,01 дюйма. Положительный x — справа; положительный y работает. |
|
Каждая логическая единица сопоставляется с 0,1 миллиметра. Положительный x — справа; положительный y работает. |
|
Каждая логическая единица сопоставляется с одним пикселем устройства. Положительный x — справа; положительный y не работает. |
|
Каждая логическая единица сопоставляется с одной двадцатой точки принтера (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 |
См. также раздел
Функции координатного пространства и преобразования
Общие сведения о координатных пространствах и преобразованиях