Funzione ScriptRecordDigitSubstitution (usp10.h)
Legge le impostazioni di sostituzione della cifra nativa e della cifra nativa (NLS) e le registra in una struttura di SCRIPT_DIGITSUBSTITUTE . Per altre informazioni, vedere Forme cifre.
Sintassi
HRESULT ScriptRecordDigitSubstitution(
[in] LCID Locale,
[out] SCRIPT_DIGITSUBSTITUTE *psds
);
Parametri
[in] Locale
Identificatore delle impostazioni locali delle impostazioni locali da eseguire in query. In genere, l'applicazione deve impostare questo parametro su LOCALE_USER_DEFAULT. In alternativa, l'impostazione può indicare impostazioni locali specifiche combinate con LOCALE_NOUSEROVERRIDE per ottenere le impostazioni predefinite.
[out] psds
Puntatore a una struttura SCRIPT_DIGITSUBSTITUTE . Questa struttura può essere passata più avanti a ScriptApplyDigitSubstitution.
Valore restituito
Restituisce S_OK se riuscito. La funzione restituisce un valore HRESULT diverso da zero se non riesce.
L'errore restituisce include:
- E_INVALIDARG. Il parametro Impostazioni locali indica impostazioni locali non valide o non installate.
- E_POINTER. Il parametro psds è impostato su NULL.
Commenti
Per una discussione sul contesto in cui viene normalmente chiamata questa funzione, vedere Visualizzazione del testo con Uniscrivimento .
Questa funzione supporta la sostituzione della cifra di contesto solo per le impostazioni locali arabo e persiane. Per altre impostazioni locali, la sostituzione delle cifre di contesto viene mappata a nessuna sostituzione.
Nell'esempio seguente viene illustrato il modo tipico per chiamare questa funzione.
SCRIPT_DIGITSUBSTITUTE sds;
ScriptRecordDigitSubstitution(LOCALE_USER_DEFAULT, &sds);
In ogni elementoizzazione, l'applicazione può usare i risultati, come illustrato nell'esempio successivo.
SCRIPT_CONTROL sc = {0};
SCRIPT_STATE ss = {0};
ScriptApplyDigitSubstitution(&sds, &sc, &ss);
Per motivi di prestazioni, l'applicazione non deve chiamare spesso ScriptRecordDigitSubstitution . La funzione richiede un sovraccarico notevole per chiamarla ogni volta che ScriptItemize o ScriptStringAnalyse viene chiamato. L'applicazione può invece salvare la struttura SCRIPT_DIGITSUBSTITUTE e aggiornarla solo quando viene ricevuto un messaggio di WM_SETTINGCHANGE . In alternativa, l'applicazione può aggiornare la struttura quando una chiamata RegNotifyChangeKeyValue in un thread dedicato indica una modifica nel Registro di sistema in HKCU\Pannello di controllo\International.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | usp10.h |
| Libreria | Usp10.lib |
| DLL | Usp10.dll |