GetTextFaceA-Funktion (wingdi.h)

Artikel
08/27/2023

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 lpFaceName verweist. Für die ANSI-Funktion handelt es sich um eine BYTE-Anzahl und für die Unicode-Funktion um eine WORD-Anzahl. Beachten Sie, dass für die ANSI-Funktion zeichen in SBCS-Codepages jeweils ein Byte verwendet werden, während die meisten Zeichen in DBCS-Codepages zwei Bytes umfassen. für die Unicode-Funktion sind die meisten derzeit definierten Unicode-Zeichen (die in der basic Multilingual Plane (BMP)) ein WORD, während Unicode-Ersatzzeichen 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 abschließenden NULL-Zeichens.

Rückgabewert

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

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

Hinweise

Der Name der Schriftart wird als NULL-endende Zeichenfolge kopiert.

Wenn der Name länger als die durch den nCount-Parameter angegebene Anzahl von Zeichen ist, wird der Name abgeschnitten.

Hinweis

Der wingdi.h-Header definiert GetTextFace 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


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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll