ScriptRecordDigitSubstitution-Funktion (usp10.h)

Artikel
08/26/2023

Liest die nativen Einstellungen für die Ersetzung von Ziffern und Ziffern von National Language Support (NLS) und zeichnet sie in einer SCRIPT_DIGITSUBSTITUTE-Struktur auf. Weitere Informationen finden Sie unter Digit Shapes.

Syntax

HRESULT ScriptRecordDigitSubstitution(
  [in]  LCID                   Locale,
  [out] SCRIPT_DIGITSUBSTITUTE *psds
);

Parameter

[in] Locale

Gebietsschemabezeichner des abzufragenden Gebietsschemas. In der Regel sollte die Anwendung diesen Parameter auf LOCALE_USER_DEFAULT festlegen. Alternativ kann die Einstellung ein bestimmtes Gebietsschema in Kombination mit LOCALE_NOUSEROVERRIDE angeben, um die Standardeinstellungen abzurufen.

[out] psds

Zeiger auf eine SCRIPT_DIGITSUBSTITUTE-Struktur . Diese Struktur kann später an ScriptApplyDigitSubstitution übergeben werden.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen nichtzero-HRESULT-Wert zurück, wenn er nicht erfolgreich ist.

Fehlerrückmeldungen umfassen:

E_INVALIDARG. Der Locale-Parameter gibt ein Gebietsschema an, das ungültig oder nicht installiert ist.
E_POINTER. Der psds-Parameter ist auf NULL festgelegt.

Hinweise

Eine Diskussion über den Kontext, in dem diese Funktion normalerweise aufgerufen wird, finden Sie unter Anzeigen von Text mit Uniscribe .

Diese Funktion unterstützt die Kontextstellenersetzung nur für arabische und persische Gebietsschemas. Bei anderen Gebietsschemas wird die Ersetzung von Kontextziffern keiner Ersetzung zugeordnet.

Das folgende Beispiel zeigt die typische Methode zum Aufrufen dieser Funktion.

SCRIPT_DIGITSUBSTITUTE sds;
ScriptRecordDigitSubstitution(LOCALE_USER_DEFAULT, &sds);

Bei jeder Elementisierung kann die Anwendung die Ergebnisse verwenden, wie im nächsten Beispiel gezeigt.

SCRIPT_CONTROL sc = {0};
SCRIPT_STATE   ss = {0};
ScriptApplyDigitSubstitution(&sds, &sc, &ss);

Aus Leistungsgründen sollte Ihre Anwendung ScriptRecordDigitSubstitution nicht häufig aufrufen. Die Funktion erfordert einen erheblichen Mehraufwand, um sie jedes Mal aufzurufen , wenn ScriptItemize oder ScriptStringAnalyse aufgerufen wird. Stattdessen kann die Anwendung die SCRIPT_DIGITSUBSTITUTE-Struktur speichern und nur aktualisieren, wenn eine WM_SETTINGCHANGE Nachricht empfangen wird. Alternativ kann die Anwendung die Struktur aktualisieren, wenn ein RegNotifyChangeKeyValue-Aufruf in einem dedizierten Thread eine Änderung in der Registrierung unter HKCU\Systemsteuerung\International anzeigt.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in seiner Bibliotheksliste angeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll