Функция GetTextAlign извлекает настройки выравнивания текста для заданного контекста устройства.
Синтаксис
UINT GetTextAlign( HDC hdc // дескриптор DC ); |
Параметры
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - состояние флажков выравнивания текста. Для получения дополнительной информации о возвращаемом значении, см. раздел Замечаний. Возвращаемое значение - комбинация нижеследующих значений.
Значение | Предназначение |
---|---|
TA_BASELINE | Опорная точка находится на базовой линии текста. |
TA_BOTTOM | Опорная точка на нижней кромке рабочего прямоугольника. |
TA_TOP | Опорная точка на верхней кромке рабочего прямоугольника. |
TA_CENTER | Опорная точка выравнивается горизонтально по центру рабочего прямоугольника. |
TA_LEFT | Опорная точка находится на левой кромке рабочего прямоугольника. |
TA_RIGHT | Опорная точка находится на правой кромке рабочего прямоугольника. |
TA_RTLREADING | Редакция Windows на языках Ближнего Востока: Текст размечается для порядка чтения справа налево , в противоположность порядку чтения по умолчанию слева направо. Это применяется только тогда, когда шрифт, выбранный в контекст устройства предназначен или для Еврейского или для Арабского языка. |
TA_NOUPDATECP | Текущая позиция не модифицируется после каждого вызова вывода текста. |
TA_UPDATECP | Текущая позиция модифицируется после каждого вызова вывода текста. |
Когда текущий шрифт имеет вертикальную заданную по умолчанию базовую линию (такой как Kanji), вместо TA_BASELINE и TA_CENTER используются нижеследующие значения.
Значение | Предназначение |
---|---|
VTA_BASELINE | Опорная точка находится на базовой линии текста. |
VTA_CENTER | Опорная точка выравнивается вертикально по центру рабочего прямоугольника. |
Если функция завершается с ошибкой, возвращаемое значение - GDI_ERROR.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Рабочий прямоугольник - прямоугольник, ограничивающий все символьные знакоместа в строке текста. Его размеры могут быть получены при помощи вызова функция GetTextExtentPoint32 .
Флажки выравнивания текста обуславливают, как функции TextOut и ExtTextOut должны выравнивать строку текста относительно опорной точки строки, предусмотренной в TextOut или ExtTextOut.
Флажки выравнивания текста - не обязательно одиночные биты флажков и могут быть равны нулю. Флажки должны быть проверены в группах родственных флажков, как показано в нижеследующем списке.
TA_LEFT, TA_RIGHT и TA_CENTER
TA_BOTTOM, TA_TOP и TA_BASELINE
TA_NOUPDATECP и TA_UPDATECP
Если текущий шрифт имеет вертикальную заданную по умолчанию базовую линию, родственные флажки показаны в нижеследующем списке.
TA_LEFT, TA_RIGHT и VTA_BASELINE
TA_BOTTOM, TA_TOP и VTA_CENTER
TA_NOUPDATECP и TA_UPDATECP
Чтобы проверить, что конкретный флажок установлен в возвращаемом значении этой функции
Пример смотри в статье Параметры выравнивания текста.
Обзор шрифты и текст, Функции, используемые шрифтами и текстом, ExtTextOut, GetTextExtentPoint32, SetTextAlign, TextOut
Размещение и совместимость GetTextAlign |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
Gdi32.lib |
Заголовочный файл |
|
- объявлено в |
Wingdi.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |