Функция ExtTextOutWrap

  • Статья

[ExtTextOutWrap доступен в Windows XP с пакетом обновления 2 (SP2). В последующих версиях он может быть изменен или недоступен. Рекомендуется использовать extTextOut напрямую.]

Рисует текст с помощью выбранного шрифта, цвета фона и цвета текста. При необходимости можно указать измерения, которые будут использоваться для обрезки, непрозрачности или и того, и другого. Эта функция заключает в оболочку вызов ExtTextOut.

Синтаксис

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

Параметры

hdc [in]

Тип: HDC

Дескриптор контекста устройства.

X [in]

Тип: int

Координата X в логических координатах точки отсчета, используемой для размещения строки.

Y [in]

Тип: int

Координата Y в логических координатах точки отсчета, используемой для размещения строки.

uOptions [in]

Тип: UINT

Значения, указывающие способ использования прямоугольника, определяемого приложением. Полный список параметров см. в разделе ExtTextOut .

lprc [in]

Тип: const RECT*

Указатель на необязательную структуру RECT , указывающую размеры прямоугольника в логических координатах, используемого для обрезки, непрозрачности или и того, и другого.

lpString [in]

Тип: LPCTSTR

Указатель на буфер, содержащий текст для рисования. Строка не обязательно должна заканчиваться с нуля, так как cbCount указывает длину строки.

cbCount [in]

Тип: UINT

Длина строки в байтах, на которую указывает lpString.

lpDx [in]

Тип: const INT*

Указатель на необязательный массив значений, указывающий расстояние между источниками смежных символьных ячеек. Например, логические единицы lpDx[x] отделяют происхождение символьной ячейки x и ячейки символов (x + 1).

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

Тип: BOOL

Возвращает ненулевое значение, если строка успешно нарисована. Однако если версия ANSI ExtTextOut вызывается с ETO_GLYPH_INDEX, функция возвращает значение TRUE , даже если функция ничего не делает.

Если функция выполняется неудачно, возвращается нулевое значение.

Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

ExtTextOutWrap не экспортируется по имени и не объявляется в открытом файле заголовка. Чтобы использовать его, необходимо использовать GetProcAddress и запросить порядковый номер 417 из ComCtl32.dll, чтобы получить указатель на функцию.

Дополнительные замечания см. в разделе ExtTextOut.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Comctl32.dll (версия 6.0 или более поздняя)