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

Статья
03/09/2024

Функция SetLayout изменяет макет контекста устройства (DC).

Синтаксис

DWORD SetLayout(
  [in] HDC   hdc,
  [in] DWORD l
);

Параметры

[in] hdc

Дескриптор контроллера домена.

[in] l

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

Значение	Значение
LAYOUT_BITMAPORIENTATIONPRESERVED	Отключает любое отражение во время операций BitBlt и StretchBlt .
LAYOUT_RTL	Задает по умолчанию горизонтальный макет справа налево.

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

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

Если функция завершается сбоем, она возвращает GDI_ERROR.

Макет определяет порядок отображения текста и графики в окне или контексте устройства. Значение по умолчанию — слева направо. Функция SetLayout изменяет значение справа налево, что является стандартом в арабском и иврите.

После выбора LAYOUT_RTL флаги, обычно указывающие правое или левое, отменяются. Чтобы избежать путаницы, рассмотрите возможность определения альтернативных слов для стандартных флагов, таких как в следующей таблице.

Стандартный флаг	Предлагаемое альтернативное имя
WS_EX_RIGHT	WS_EX_TRAILING
WS_EX_RTLREADING	WS_EX_REVERSEREADING
WS_EX_LEFTSCROLLBAR	WS_EX_LEADSCROLLBAR
ES_LEFT	ES_LEAD
ES_RIGHT	ES_TRAIL
EC_LEFTMARGIN	EC_LEADMARGIN
EC_RIGHTMARGIN	EC_TRAILMARGIN

SetLayout не может изменять рисование непосредственно в битах DIB.

Дополнительные сведения см. в разделе "Макет окна и зеркальное отображение" статьи Функции окон.

Требования

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

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

Функции контекста устройства

Общие сведения о контекстах устройств

GetLayout

Share via