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

Статья
08/27/2023

Функция ModifyWorldTransform изменяет преобразование мира для контекста устройства с помощью указанного режима.

Синтаксис

BOOL ModifyWorldTransform(
  [in] HDC         hdc,
  [in] const XFORM *lpxf,
  [in] DWORD       mode
);

Параметры

[in] hdc

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

[in] lpxf

Указатель на структуру XFORM, используемую для изменения преобразования мира для заданного контекста устройства.

[in] mode

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

Значение	Значение
MWT_IDENTITY	Сбрасывает текущее преобразование мира с помощью матрицы удостоверений. Если указан этот режим, структура XFORM , на которую указывает lpXform , игнорируется.
MWT_LEFTMULTIPLY	Умножает текущее преобразование на данные в структуре XFORM . (Данные в структуре XFORM становятся левой мультипликаторной, а данные для текущего преобразования — правой.)
MWT_RIGHTMULTIPLY	Умножает текущее преобразование на данные в структуре XFORM . (Данные в структуре XFORM становятся правой мультипликаторной, а данные для текущего преобразования — левой.)

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

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

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

Функция ModifyWorldTransform завершится ошибкой , если для указанного контекста устройства не был задан режим графики GM_ADVANCED путем вызова функции SetGraphicsMode . Аналогичным образом невозможно сбросить графический режим для контекста устройства в режим GM_COMPATIBLE по умолчанию, если преобразование мира сначала не было сброшено до преобразования идентификаторов по умолчанию путем вызова SetWorldTransform или ModifyWorldTransform.

Требования


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