CDC::ExtTextOut

Статья
02/20/2013

Эта функция-член вызывается для записи в строку символов, в которой содержится прямоугольная область, используя выбранный шрифт.

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 
);

Параметры

x
Указывает логическую пару координат (x ячейки символа для первого символа в заданной строке.
y
Идентифицирует логический координату по оси y верхней части ячейки символа для первого символа в заданной строке.
nOptions
Указывает тип прямоугольника.Этот параметр может быть один, оба или ни одним из из следующих значений:
- ETO_CLIPPED Указывает, что текст обрезается в прямоугольник.
- ETO_OPAQUE Указывает, что текущие заполнения цвета фона прямоугольника.(Можно задавать и запрашивать текущий цвет фона с функции-членами SetBkColor и GetBkColor).
lpRect
Указатель на структуру RECT, которая задает размеры прямоугольника.Этот параметр может быть NULL.Можно также передать объект CRect для этого параметра.
lpszString
Указывает на заданной строке символов для рисования.Можно также передать объект CString для этого параметра.
nCount
Указывает число символов в строке.
lpDxWidths
Указатель на массив значений, указывающие расстояние между началами координат смежных ячеек знака.Например, логические блоки lpDxWidths[I] Отделят начала координат ячейки символа i и ячейка символа i + 1.Если lpDxWidthsNULL, то ExtTextOut по умолчанию использует интервалы между символами.
str
Объект CString, который содержит указанные символы для рисования.

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

Ненулевой если функция успешно; в противном случае – значение 0.

Заметки

Прямоугольная область может быть опакова (залитый с текущим цветом фона) и может быть областью отсечения.

Если nOptions 0 и lpRectNULL, записи функции вставке СМС на контекст устройства без использования прямоугольной области.По умолчанию текущая позиция не используется и не изменялись функцией.Если приложению необходимо обновить текущую позицию, когда она вызывает ExtTextOut, приложение может вызвать функцию-член SetTextAlignCDC с nFlags, для TA_UPDATECP.Если пометить установлен, Windows не учитывает x и y при последующих вызовах ExtTextOut и использует текущую позицию.Когда приложение использует TA_UPDATECP чтобы обновить текущую позицию, ExtTextOut задает текущую позицию или на конец предыдущей линии текста или в позиции, указанной последним элементом массива, указанного в lpDxWidths, какая из этих величин больше.