Partager via


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

Récupère le module de reconnaissance par défaut d’une langue connue, spécifié par un identificateur de code de langue (LCID) de prise en charge des langues nationales (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 les 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 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 retournée

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

Code de retour Description
S_OK
Réussite.
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.

Notes

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 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 de 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 aux paramètres régionaux d’entrée de l’utilisateur. S’il n’y en a pas, il vérifie s’il existe un module de reconnaissance correspondant aux paramètres régionaux système actuels.

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

Spécifications

   
Client minimal pris en charge Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête msinkaut.h
Bibliothèque InkObj.dll

Voir aussi

IInkRecognizer, interface

IInkRecognizers

InkRecognizers Collection