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

Статья
08/27/2023

Функция 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 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll