PolyTextOutA-Funktion (wingdi.h)

Artikel
11/20/2024

Die PolyTextOut--Funktion zeichnet mehrere Zeichenfolgen mithilfe der schriftarten- 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 POLYTEXT- Strukturen, die die zu zeichnenden Zeichenfolgen beschreiben. 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 fehlschlägt, ist der Rückgabewert null.

Bemerkungen

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- wird die unterstützung für internationale Skripts nicht automatisch behandelt. Um internationale Skriptunterstützung zu erhalten, verwenden Sie stattdessen ExtTextOut-. ExtTextOut- verwendet Uniscribe, wenn dies erforderlich ist, was zu einem Fallback der Schriftart führt. Darüber hinaus führt ExtTextOut- interne Batchverarbeitung von Aufrufen vor dem Übergang in den Kernelmodus durch, wobei einige der Leistungsbedenken beim Abwägen der Verwendung von PolyTextOut- im Vergleich zu ExtTextOut-abgemildert werden.

Trinkgeld

ExtTextOut- wird aufgrund der Fähigkeit, die Anzeige verschiedener Sprachen zu verarbeiten, über PolyTextOut- für die moderne Entwicklung dringend empfohlen.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll