Funzione ScriptRecordDigitSubstitution (usp10.h)

Articolo
08/26/2023

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.

Importante A partire da Windows 8: per mantenere la possibilità di eseguire in Windows 7, un modulo che usa Uniscribe deve specificare Usp10.lib prima di gdi32.lib nell'elenco delle librerie.

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