Функция GetTextAlign

Функция GetTextAlign извлекает настройки выравнивания текста для заданного контекста устройства.

Синтаксис

UINT GetTextAlign(
  HDC hdc            // дескриптор DC
);

Параметры

hdc
[in] Дескриптор контекста устройства.

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

Если функция завершается успешно, возвращаемое значение - состояние флажков выравнивания текста. Для получения дополнительной информации о возвращаемом значении, см. раздел Замечаний. Возвращаемое значение - комбинация нижеследующих значений.

Значение Предназначение
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

Чтобы проверить, что конкретный флажок установлен в возвращаемом значении этой функции

  1. Примените побитовый оператор OR к флажку и его родственным флажкам.
  2. Примените побитовый оператор AND к результату и возвращаемому значению.
  3. Проверьте равенство этих результатов и флажков.

Код примера

Пример смотри в статье Параметры выравнивания текста

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz