Шаг 788 - CDC::ExtTextOut

virtual BOOL ExtTextOut( int x, int y, UINT nOptions, LPCRECT lpRect, LPCTSTR lpszString, UINT nCount, LPINT lpDxWidths );
BOOL ExtTextOut( int x, int y, UINT nOptions, LPCRECT lpRect, const CString& str, LPINT lpDxWidths );

Возвращаемое значение
Отлично от нуля, если функция успешна, иначе 0.

Параметры
x
Определяет логическую x-координату символьной ячейки для первого символа в определенной строке.
y
Определяет логическую y-координату верхней части символьной ячейки для первого символа в определенной строке.
nOptions
Определяет тип прямоугольника. Этот параметр может быть один, оба, или ни одно из следующих значений:

lpRect
Указатель на структуру RECT, которая определяет размерности прямоугольника. Этот параметр может быть NULL. Вы можете также передавать объект CRect для этого параметра.
lpszString
Указатель на определенную символьную строку, которая будет выведена. Вы можете также передавать объект CString для этого параметра.
nCount
Определяет число символов в строке.
lpDxWidths
Указатель на массив значений, которые указывают расстояние между происхождением смежных символьных ячеек. Например, lpDxWidths [i] логические модули отделит происхождение символьной ячейки и символьная ячейка + 1. Если lpDxWidths NULL, ExtTextOut использует значение по умолчанию, располагающее между символами.
str
Объект CString, который содержит определенные символы, которые будут выведены.

Замечания
Вызовите эту функцию, чтобы записать символьную строку внутри прямоугольной области, использующей в настоящее время выбранный шрифт. Прямоугольная область может быть непрозрачна (заполнена текущим фоновым цветом), и это может быть область отсечения.
Если nOptions - 0, и lpRect NULL, текст выводиться в контекст устройства без того, чтобы использовать прямоугольную область. По умолчанию, текущая позиция не используется или модифицируется функцией. Если прикладная программа должна модифицировать текущую позицию, когда это вызывает ExtTextOut, прикладная программа может вызывать функцию CDC SetTextAlign с набором nFlags к TA_UPDATECP. Когда этот флажок установлен, Windows игнорирует x и y на последующих обращениях к ExtTextOut и использует текущую позицию вместо этого. Когда прикладная программа использует TA_UPDATECP, чтобы модифицировать текущую позицию, ExtTextOut устанавливает текущую позицию или к концу предыдущей строки текста или к позиции, определенной последним элементом массива, указанного в lpDxWidths.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 4.02.2002