Función ScriptRecordDigitSubstitution (usp10.h)
Lee la configuración de sustitución de dígitos y dígitos nativos de National Language Support (NLS) y los registra en una estructura de SCRIPT_DIGITSUBSTITUTE . Para obtener más información, vea Formas de dígitos.
Sintaxis
HRESULT ScriptRecordDigitSubstitution(
[in] LCID Locale,
[out] SCRIPT_DIGITSUBSTITUTE *psds
);
Parámetros
[in] Locale
Identificador de configuración regional de la configuración regional que se va a consultar. Normalmente, la aplicación debe establecer este parámetro en LOCALE_USER_DEFAULT. Como alternativa, la configuración puede indicar una configuración regional específica combinada con LOCALE_NOUSEROVERRIDE para obtener la configuración predeterminada.
[out] psds
Puntero a una estructura de SCRIPT_DIGITSUBSTITUTE . Esta estructura se puede pasar más adelante a ScriptApplyDigitSubstitution.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente. La función devuelve un valor HRESULT distinto de cero si no se realiza correctamente.
Los errores devueltos incluyen:
- E_INVALIDARG. El parámetro Locale indica una configuración regional que no es válida o no está instalada.
- E_POINTER. El parámetro psds se establece en NULL.
Comentarios
Vea Mostrar texto con Uniscribe para obtener una explicación del contexto en el que normalmente se llama a esta función.
Esta función solo admite la sustitución de dígitos de contexto para las configuraciones regionales árabe y persa. Para otras configuraciones regionales, la sustitución de dígitos de contexto se asigna a ninguna sustitución.
En el ejemplo siguiente se muestra la manera típica de llamar a esta función.
SCRIPT_DIGITSUBSTITUTE sds;
ScriptRecordDigitSubstitution(LOCALE_USER_DEFAULT, &sds);
En cada itemización, la aplicación puede usar los resultados como se muestra en el ejemplo siguiente.
SCRIPT_CONTROL sc = {0};
SCRIPT_STATE ss = {0};
ScriptApplyDigitSubstitution(&sds, &sc, &ss);
Por motivos de rendimiento, la aplicación no debe llamar a ScriptRecordDigitSubstitution con frecuencia. La función requiere una sobrecarga considerable para llamarla cada vez que se llama a ScriptItemize o ScriptStringAnalyse . En su lugar, la aplicación puede guardar la estructura de SCRIPT_DIGITSUBSTITUTE y actualizarla solo cuando se recibe un mensaje de WM_SETTINGCHANGE . Como alternativa, la aplicación puede actualizar la estructura cuando una llamada RegNotifyChangeKeyValue en un subproceso dedicado indica un cambio en el registro en HKCU\Panel de control\International.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | usp10.h |
| Library | Usp10.lib |
| Archivo DLL | Usp10.dll |