Функция PolyTextOutA (wingdi.h)

Статья
11/20/2024

Функция PolyTextOut рисует несколько строк, используя цвета шрифта и текста, выбранные в данный момент в указанном контексте устройства.

Синтаксис

BOOL PolyTextOutA(
  [in] HDC             hdc,
  [in] const POLYTEXTA *ppt,
  [in] int             nstrings
);

Параметры

[in] hdc

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

[in] ppt

Указатель на массив POLYTEXT структуры, описывающие строки, которые нужно нарисовать. Массив содержит одну структуру для каждой строки, нарисуемой.

[in] nstrings

Количество структур POLYTEXT в массиве pptxt.

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

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

Если функция завершается ошибкой, возвращаемое значение равно нулю.

Замечания

Каждая структура POLYTEXT содержит координаты эталонной точки, которую Windows использует для выравнивания соответствующей строки текста. Приложение может указать, как используется эталонная точка, вызвав функцию SetTextAlign. Приложение может определить текущий параметр выравнивания текста для указанного контекста устройства, вызвав функцию GetTextAlign.

Чтобы нарисовать одну строку текста, приложение должно вызвать функцию ExtTextOut.

PolyTextOut не будет автоматически обрабатывать поддержку международных сценариев. Чтобы получить поддержку международных сценариев, используйте вместо этого ExtTextOut. ExtTextOut будет использовать Uniscribe при необходимости, что приведет к резервному использованию шрифта. Кроме того, ExtTextOut будет выполнять внутреннюю пакетную обработку вызовов перед переходом в режим ядра, уменьшая некоторые проблемы производительности при взвешивании использования PolyTextOut и ExtTextOut.

Кончик

ExtTextOut настоятельно рекомендуется по сравнению с PolyTextOut для современной разработки из-за его способности обрабатывать отображение различных языков.

Заметка

Заголовок wingdi.h определяет PolyTextOut как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll