PolyTextOutA-Funktion (wingdi.h)

Artikel
03/04/2024

Die PolyTextOut-Funktion zeichnet mehrere Zeichenfolgen unter Verwendung der Schriftart- und Textfarben, die derzeit im angegebenen Gerätekontext ausgewählt sind.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] ppt

Ein Zeiger auf ein Array von POLYTEXT-Strukturen , das die zu zeichnenden Zeichenfolgen beschreibt. Das Array enthält eine Struktur für jede zu zeichnende Zeichenfolge.

[in] nstrings

Die Anzahl der POLYTEXT-Strukturen im pptxt-Array .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Jede POLYTEXT-Struktur enthält die Koordinaten eines Referenzpunkts, den Windows zum Ausrichten der entsprechenden Textzeichenfolge verwendet. Eine Anwendung kann angeben, wie der Referenzpunkt verwendet wird, indem die SetTextAlign-Funktion aufgerufen wird. Eine Anwendung kann die aktuelle Textausrichtungseinstellung für den angegebenen Gerätekontext ermitteln, indem sie die GetTextAlign-Funktion aufruft.

Um eine einzelne Textzeichenfolge zu zeichnen, sollte die Anwendung die ExtTextOut-Funktion aufrufen.

PolyTextOut verarbeitet internationale Skriptunterstützung nicht automatisch. Verwenden Sie stattdessen ExtTextOut , um internationale Skriptunterstützung zu erhalten. ExtTextOut verwendet bei Bedarf Uniscribe , was zu einem Schriftartfallback führt. Darüber hinaus führt ExtTextOut vor dem Übergang in den Kernelmodus internes Batching von Aufrufen aus, um einige der Leistungsprobleme beim Abwägen der Verwendung von PolyTextOut und ExtTextOut zu verringern.

Tipp

ExtTextOut wird dringend gegenüber PolyTextOut für die moderne Entwicklung empfohlen, da es die Anzeige verschiedener Sprachen verarbeiten kann.

Hinweis

Der wingdi.h-Header definiert PolyTextOut als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll