Método IInkRecognizers::GetDefaultRecognizer (msinkaut.h)

Recupera el reconocedor predeterminado para un idioma conocido, especificado por un identificador de código de idioma (LCID) de compatibilidad con idiomas nacionales (NLS).

Sintaxis

HRESULT GetDefaultRecognizer(
  [in]          long           lcid,
  [out, retval] IInkRecognizer **DefaultRecognizer
);

Parámetros

[in] lcid

Identificador de configuración regional de LCID del idioma para el que se va a recuperar el reconocedor predeterminado. Si lcid es 0, el método usa la configuración regional del usuario para determinar qué reconocedor predeterminado se va a recuperar. Si el usuario no ha especificado una configuración regional en Opciones regionales, el método usa la configuración regional que se especificó para el equipo. El valor predeterminado es 0.

[out, retval] DefaultRecognizer

Cuando este método vuelve, contiene un puntero al reconocedor solicitado.

Valor de retorno

Este método puede devolver uno de estos valores.

Código de retorno Descripción
S_OK
Éxito.
E_POINTER
Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION
Se produjo una excepción dentro del método .
E_INVALIDARG
La marca no es válida.
E_UNEXPECTED
Parámetro o tipo de propiedad inesperados.

Observaciones

Cada idioma puede tener un reconocedor predeterminado. Por ejemplo, un usuario puede tener un reconocedor predeterminado para inglés de EE. UU. y un reconocedor predeterminado para francés. Si no se especifica ninguna configuración regional, este método devuelve el reconocedor para la configuración regional de entrada activa. Para seleccionar la configuración regional de entrada activa, en opciones regionales y de idioma en ControlPanel, en la pestaña Idiomas, los usuarios hacen clic en Detalles y, a continuación, seleccionan el idioma de entrada predeterminado.

El valor predeterminado del parámetro lcid es 0.

Este método genera un error si el parámetro lcid no es una configuración regional conocida o si un reconocedor no está instalado para la configuración regional solicitada.

GetDefaultRecognizer comprueba primero si hay un reconocedor coincidente para la configuración regional de entrada del usuario. Si no hay ninguno, comprueba si hay un reconocedor coincidente para la configuración regional del sistema actual.

Para obtener más información sobre NLS, consulte Terminología de NLS.

Requisitos

Requisito Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header msinkaut.h

Consulte también

IInkRecognizer (interfaz)

IInkRecognizers

Colección InkRecognizers