Función ScriptRecordDigitSubstitution (usp10.h)

Artículo
08/26/2023

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.

Importante A partir de Windows 8: para mantener la capacidad de ejecutarse en Windows 7, un módulo que usa Uniscribe debe especificar Usp10.lib antes de gdi32.lib en su lista de bibliotecas.

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