GetTextCharsetInfo-Funktion (wingdi.h)

Ruft Informationen zum Zeichensatz der Schriftart ab, die derzeit in einem angegebenen Gerätekontext ausgewählt ist.

Syntax

int GetTextCharsetInfo(
  [in]            HDC             hdc,
  [out, optional] LPFONTSIGNATURE lpSig,
  [in]            DWORD           dwFlags
);

Parameter

[in] hdc

Handle für einen Gerätekontext. Die Funktion ruft Informationen über die Schriftart ab, die in diesem Gerätekontext ausgewählt ist.

[out, optional] lpSig

Zeiger auf eine FONTSIGNATURE-Datenstruktur , die Schriftsignaturinformationen empfängt.

Wenn derzeit eine TrueType-Schriftart im Gerätekontext ausgewählt ist, empfängt die FONTSIGNATURE-Struktur Informationen, die die Codepage und Unicode-Unterbereiche identifiziert, für die die Schriftart Glyphen bereitstellt.

Wenn derzeit eine andere Schriftart als TrueType im Gerätekontext ausgewählt ist, empfängt die FONTSIGNATURE-Struktur Nullen. In diesem Fall sollte die Anwendung die TranslateCharsetInfo-Funktion verwenden, um generische Schriftsignaturinformationen für den Zeichensatz abzurufen.

Der parameter lpSig gibt NULL an, wenn die Anwendung die FONTSIGNATURE-Informationen nicht benötigt. In diesem Fall kann die Anwendung auch die GetTextCharset-Funktion aufrufen, die dem Aufrufen von GetTextCharsetInfo entspricht, wobei lpSig auf NULL festgelegt ist.

[in] dwFlags

Reserviert; muss auf 0 festgelegt werden.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Wert zurück, der den Zeichensatz der Schriftart angibt, die derzeit im angegebenen Gerätekontext ausgewählt ist. Die folgenden Zeichensatzbezeichner sind definiert:

Wenn die Funktion fehlschlägt, wird der Rückgabewert DEFAULT_CHARSET.

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

Weitere Informationen

FONTSIGNATURE

GetTextCharset

TranslateCharsetInfo

Unicode- und Zeichensatzfunktionen

Unicode und Zeichensätze