GetTextFaceA-Funktion (wingdi.h)

Artikel
11/20/2024

Die GetTextFace--Funktion ruft den Schriftartnamen der Schriftart ab, die im angegebenen Gerätekontext ausgewählt ist.

Syntax

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] c

Die Länge des Puffers, auf den lpFaceNameverweist. Für die ANSI-Funktion handelt es sich um eine BYTE-Zählung und für die Unicode-Funktion ist sie eine WORD-Anzahl. Beachten Sie, dass für die ANSI-Funktion Zeichen in SBCS-Codeseiten jeweils ein Byte verwendet werden, während die meisten Zeichen in DBCS-Codeseiten zwei Byte beanspruchen; für die Unicode-Funktion sind die derzeit definierten Unicode-Zeichen (die im Basic Multilingual Plane (BMP)) ein WORT sind, während Unicode-Surrogate zwei WORDs sind.

[out] lpName

Ein Zeiger auf den Puffer, der den Namen der Schriftart empfängt. Wenn dieser Parameter NULL-ist, gibt die Funktion die Anzahl der Zeichen im Namen zurück, einschließlich des endenden NULL-Zeichens.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Zeichen, die in den Puffer kopiert wurden.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null.

Bemerkungen

Der Name der Schriftart wird als null-beendete Zeichenfolge kopiert.

Wenn der Name länger als die Anzahl von Zeichen ist, die durch den parameter nCount angegeben werden, wird der Name abgeschnitten.

Anmerkung

The wingdi.h header defines GetTextFace as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. 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