Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |
