ScriptRecordDigitSubstitution-Funktion (usp10.h)
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.
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 |