На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetTextAlign



The GetTextAlign function retrieves the text-alignment setting for the specified device context.

UINT GetTextAlign(

HDC hdc // handle of device context
);


Parameters

hdc

Identifies the device context.



Return Values

If the function succeeds, the return value is the status of the text-alignment flags.
If the function fails, the return value is GDI_ERROR. To get extended error information, call GetLastError.
For a list of status return values, see the Remarks section. The return value is a combination of one or more of the following values:

Value Meaning
TA_BASELINE The reference point is on the base line of the text.
TA_BOTTOM The reference point is on the bottom edge of the bounding rectangle.
TA_TOP The reference point is on the top edge of the bounding rectangle.
TA_CENTER The reference point is aligned horizontally with the center of the bounding rectangle.
TA_LEFT The reference point is on the left edge of the bounding rectangle.
TA_RIGHT The reference point is on the right edge of the bounding rectangle.
TA_RTLREADING Windows 95 only: The text is laid out in right to left reading order, as opposed to the default left to right order. This only applies when the font selected into the device context is either Hebrew or Arabic.
TA_NOUPDATECP The current position is not updated after each text output call.
TA_UPDATECP The current position is updated after each text output call.


When the current font has a vertical default base line (as with Kanji), the following values are used instead of TA_BASELINE and TA_CENTER:

Value Meaning
VTA_BASELINE The reference point is on the base line of the text.
VTA_CENTER The reference point is aligned vertically with the center of the bounding rectangle.


Remarks

The bounding rectangle is a rectangle bounding all of the character cells in a string of text. Its dimensions can be obtained by calling the GetTextExtentPoint32 function.
The text-alignment flags determine how the TextOut and ExtTextOut functions align a string of text in relation to the string's reference point provided to TextOut or ExtTextOut.
The text-alignment flags are not necessarily single bit flags and may be equal to zero. The flags must be examined in groups of related flags, as shown in the following list:

TA_LEFT, TA_RIGHT, and TA_CENTER
TA_BOTTOM, TA_TOP, and TA_BASELINE
TA_NOUPDATECP and TA_UPDATECP
If the current font has a vertical default base line, the related flags are as shown in the following list:
TA_LEFT, TA_RIGHT, and VTA_BASELINE
TA_BOTTOM, TA_TOP, and VTA_CENTER
TA_NOUPDATECP and TA_UPDATECP
To verify that a particular flag is set in the return value of this function, the application must perform the following steps:

1. Apply the bitwise OR operator to the flag and its related flags.
2. Apply the bitwise AND operator to the result and the return value.
3. Test for the equality of this result and the flag.



See Also

ExtTextOut, GetTextExtentPoint32, SetTextAlign, TextOut


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetTextAlign



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

UINT GetTextAlign(

HDC hdc // РУЧКА контекста устройства
);


Параметры

hdc

Идентифицирует контекст устройства.



Обратные Величины

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

Значение Величины
TA_BASELINE контрольная точка находится в базовой строке текста.
TA_BOTTOM контрольная точка находится на нижняя границе прямоугольника bounding.
TA_TOP контрольная точка находится на верхнем крае прямоугольника bounding.
TA_CENTER контрольная точка выравнивается горизонтально с центром прямоугольника bounding.
TA_LEFT контрольная точка является слева краем прямоугольника bounding.
TA_RIGHT контрольная точка находится на крае права прямоугольника bounding.
TA_RTLREADING Windows 95 только: текст положен в справа налево читать порядок, по сравнению с по умолчанию слева направо порядком. Это только относится когда шрифт выбранный в контекст устройства - или Еврейский или Арабский.
TA_NOUPDATECP текущая позиция не скорректирована после каждого текстового выходного вызова.
TA_UPDATECP текущая позиция скорректирована после каждого текстового выходного вызова.


Когда текущий шрифт имеет вертикальную по умолчанию базовую строку (как и Kanji), следующие величины использованы вместо TA_BASELINE и TA_CENTER:

Значение Величины
VTA_BASELINE контрольная точка находится в базовой строке текста.
VTA_CENTER контрольная точка выравнивается вертикально с центром прямоугольника bounding.


Замечания

Прямоугольник bounding является прямоугольником bounding все символьные ячейки в строке текста. Измерения могут быть получены вызовом функции 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. Приложите поразрядному ИЛИ оператору к флагу и связанным флагам.
2. Приложите поразрядному И оператору к результату и обратная величина.
3. Протестируйте равенство этого результата и флаг.



Смотри Также

ExtTextOut, GetTextExtentPoint32, SetTextAlign, TextOut


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz