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 |