IInkRecognizers ::GetDefaultRecognizer, méthode (msinkaut.h)

Récupère le module de reconnaissance par défaut pour une langue connue, spécifiée par un identificateur de code de langue (LCID) de prise en charge de la langue (NLS).

Syntaxe

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

Paramètres

[in] lcid

Identificateur de paramètres régionaux LCID de la langue pour laquelle vous récupérez le module de reconnaissance par défaut. Si lcid est 0, la méthode utilise le paramètre de paramètres régionaux de l’utilisateur pour déterminer le module de reconnaissance par défaut à récupérer. Si l’utilisateur n’a pas spécifié de paramètres régionaux dans Les options régionales, la méthode utilise les paramètres régionaux spécifiés pour l’ordinateur. La valeur par défaut est 0.

[out, retval] DefaultRecognizer

Lorsque cette méthode est retournée, contient un pointeur vers le module de reconnaissance demandé.

Valeur renvoyée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Opération réussie.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode.
E_INVALIDARG
L’indicateur n’est pas valide.
E_UNEXPECTED
Paramètre ou type de propriété inattendu.

Remarques

Chaque langue peut avoir un module de reconnaissance par défaut. Par exemple, un utilisateur peut avoir un module de reconnaissance par défaut pour l’anglais américain et un module de reconnaissance par défaut pour le français. Si aucun paramètre régional n’est spécifié, cette méthode retourne le module de reconnaissance pour les paramètres régionaux d’entrée actifs. Pour sélectionner les paramètres régionaux d’entrée actifs, dans les options régionales et linguistiques dans ControlPanel, sous l’onglet Langues, les utilisateurs cliquent sur Détails, puis sélectionnez la langue d’entrée par défaut.

La valeur par défaut du paramètre lcid est 0.

Cette méthode génère une erreur si le paramètre lcid n’est pas un paramètre régional connu ou si un module de reconnaissance n’est pas installé pour les paramètres régionaux demandés.

GetDefaultRecognizer vérifie d’abord s’il existe un module de reconnaissance correspondant pour les paramètres régionaux d’entrée de l’utilisateur. S’il n’y en a aucun, il vérifie s’il existe un module de reconnaissance correspondant pour les paramètres régionaux système actuels.

Pour plus d’informations sur NLS, consultez terminologie NLS.

Exigences

Prérequis Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Windows
En-tête msinkaut.h

Voir également

IInkRecognizer, interface

IInkRecognizers

InkRecognizers, collection