Partager via

Méthode IPenInputPanel::EnableTsf (peninputpanel.h)

  • Article

[ Le PenInputPanel a été remplacé par le panneau d’entrée de texte (TIP).]

Action déconseillée. Obtient ou définit une valeur booléenne qui indique si l’objet PenInputPanel tente d’envoyer du texte au contrôle attaché via l’infrastructure TSF ( Text Services Framework ) et active l’utilisation de l’interface utilisateur de correction .

Syntaxe

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Paramètres

Enable

TRUE si l’objet PenInputPanel doit tenter d’envoyer du texte au contrôle attaché à l’aide de TSF et que l’interface utilisateur de correction doit être activée ; sinon , FALSE. La valeur par défaut est TRUE.

Valeur retournée

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

Code de retour Description
S_OK
 Réussite.
E_UNEXPECTED
 Paramètre ou type de propriété inattendu.
E_NOINTERFACE
 Les interfaces TSF ne sont pas exposées sur le contrôle attaché.
E_FAIL
 Une erreur non spécifiée s'est produite.

Notes

L’appel de cette méthode avec Enable défini sur TRUE entraîne la tentative de démarrage de l’objet PenInputPanel sur le contrôle attaché.

EnableTsf doit être utilisé pour permettre au PenInputPanel d’utiliser le contexte d’insertion TSF plutôt que la fonction SendInput pour envoyer les résultats de la reconnaissance de l’écriture manuscrite dans le contrôle. Le résultat est que le texte peut être inséré même si le champ n’a plus le focus.

Lorsque vous appelez EnableTsf avec la valeur TRUE, l’objet PenInputPanel envoie un message EM_SETEDITSTYLE au contrôle attaché. Si le contrôle ne prend pas en charge ce message, les résultats peuvent être imprévisibles. Le contrôle InkEdit prend en charge TSF.

Prise en charge des applications héritées

La prise en charge a été ajoutée à TSF et Microsoft Windows pour fournir une interface utilisateur cohérente pour toutes les applications sur le bureau. Cette nouvelle prise en charge permet aux applications ou aux contrôles hérités qui ne connaissent pas TSF de tirer parti gratuitement de certains services de texte avancés. Par exemple, la dictée vocale et l’écriture manuscrite peuvent désormais être utilisées pour entrer du texte dans un document dans n’importe quelle application.

Cette nouvelle fonctionnalité est disponible et activée par défaut sur Windows XP Édition Tablet PC. Pour l’activer ou le désactiver :

  1. Dans Panneau de configuration, cliquez sur Options régionales et linguistiques.
  2. Sous l’onglet Langues , cliquez sur Détails.
  3. Sous l’onglet Avancé de la boîte de dialogue Services de texte et langues d’entrée , sélectionnez ou désactivez Étendre la prise en charge des services de texte avancés à tous les programmes.
En cas de réussite, le texte est envoyé au contrôle attaché via TSF. En outre, si le contrôle prend en charge TSF (et ne reçoit pas simplement du texte de TSF simplement parce que les services de texte avancés ont été activés pour tous les programmes dans Panneau de configuration comme indiqué ci-dessus), l’interface utilisateur de correction s’affiche dans le contrôle et permet d’accéder aux alternatives d’écriture manuscrite. L’appel de cette méthode avec Enable défini sur FALSE entraîne l’arrêt de TSF par l’objet PenInputPanel sur le contrôle attaché.

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 peninputpanel.h
Bibliothèque InkObj.dll

Voir aussi

IPenInputPanel

PenInputPanel