PenInputPanel.EnableTsf, méthode

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Indique si l'objet PenInputPanel tente ou non d'envoyer du texte au contrôle attaché via l'Infrastructure de Services de texte (TSF) et active l'interface utilisateur de correction. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
    enable As Boolean _
)
'Utilisation
Dim instance As PenInputPanel
Dim enable As Boolean

instance.EnableTsf(enable)

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public void EnableTsf(
    bool enable
)

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public:
void EnableTsf(
    bool enable
)

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public void EnableTsf(
    boolean enable
)

public function EnableTsf(
    enable : boolean
)

Paramètres

enable
Type : System.Boolean
Variable booléenne qui indique si l'objet PenInputPanel tente ou non d'envoyer le texte au contrôle attaché via l'Infrastructure de Services de texte (TSF) et active l'interface utilisateur de correction.
Si la valeur est true, l'objet PenInputPanel tente d'envoyer le texte au contrôle attaché via l'Infrastructure de Services de texte (TSF), et l'interface utilisateur de correction est activée.
Si la valeur est false, l'objet PenInputPanel tente de désactiver TSF dans le contrôle attaché. L'interface utilisateur de correction n'est pas disponible.

Notes

L'appel à cette méthode avec la valeur true affectée au paramètre enable provoque la tentative de démarrage de TSF sur le contrôle attaché par l'objet PenInputPanel.

Remarque :
La prise en charge a été ajoutée à TSF pour fournir une interface utilisateur cohérente sur toutes les applications du bureau. Cette nouvelle prise en charge permet aux applications ou aux contrôles hérités qui ne prennent pas en charge TSF de bénéficier de certains services de texte avancés. Par exemple, la reconnaissance vocale et l'écriture manuscrite peuvent maintenant être utilisées pour entrer du texte dans un document dans toute application. Cette nouvelle fonctionnalité est disponible et activée par défaut sur Microsoft® Windows® XP Édition Tablet PC. Pour activer ou désactiver la fonctionnalité : 1. Dans le Panneau de configuration, cliquez sur Options régionales et linguistiques. 2. Dans l'onglet Langues, cliquez sur Détails. 3. Dans l'onglet Options avancées de la boîte de dialogue Services de texte et langues d'entrée, activez ou désactivez Étendre les 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 de texte de TSF uniquement parce que les Services de texte avancés sont activés, comme décrit dans la procédure précédente), l'interface utilisateur de correction apparaît dans le contrôle avec un accès aux propositions de substitution d'écriture manuscrite. L'appel à cette méthode avec la valeur false affectée au paramètre enable provoque la tentative de désactivation de TSF sur le contrôle attaché par l'objet PenInputPanel.

La prise en charge a été ajoutée à TSF pour fournir une interface utilisateur cohérente sur toutes les applications du bureau. Cette nouvelle prise en charge permet aux applications ou aux contrôles hérités qui ne prennent pas en charge TSF de bénéficier de certains services de texte avancés. Par exemple, la reconnaissance vocale et l'écriture manuscrite peuvent maintenant être utilisées pour entrer du texte dans un document dans toute application.

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

1. Dans le Panneau de configuration, cliquez sur Options régionales et linguistiques.

2. Dans l'onglet Langues, cliquez sur Détails.

3. Dans l'onglet Options avancées de la boîte de dialogue Services de texte et langues d'entrée, activez ou désactivez Étendre les 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 de texte de TSF uniquement parce que les Services de texte avancés sont activés, comme décrit dans la procédure précédente), l'interface utilisateur de correction apparaît dans le contrôle avec un accès aux propositions de substitution d'écriture manuscrite. L'appel à cette méthode avec la valeur false affectée au paramètre enable provoque la tentative de désactivation de TSF sur le contrôle attaché par l'objet PenInputPanel.

Utilisez la méthode EnableTsf pour permettre au PenInputPanel d'utiliser le contexte d'insertion de TSF plutôt que lafonction SendInput (page pouvant être en anglais) pour envoyer les résultats de la reconnaissance d'écriture manuscrite au contrôle. Suite à l'activation de l'utilisation du contexte d'insertion de TSF par PenInputPanel, le texte peut être entré même si le champ n'a plus le focus.

Lorsque vous appelez cette méthode avec la valeur true affectée au paramètre enable, 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.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette méthode requiert l'autorisation SecurityPermissionFlag.AllFlags (page pouvant être en anglais), en plus des autorisations requises par PenInputPanel. Pour plus d'informations, consultez Security and Trust.

Exemples

Cet exemple C# attache un objet PenInputPanel, thePenInputPanel à un contrôle InkEdit, theInkEdit. La méthode EnableTsf est appelée sur le PenInputPanel pour démarrer le TSF.

[C#]

// Declare, create, and attach a new
// PenInputPanel to an InkEdit control.
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);

// Start the Text Services Framework
thePenInputPanel.EnableTsf(true);

Cet exemple Microsoft Visual Basic® .NET attache un objet PenInputPanel, thePenInputPanel, à un contrôle InkEdit, theInkEdit. La méthode EnableTsf est appelée sur le PenInputPanel pour démarrer le TSF.

[Visual Basic]

'Declare, create, and attach a new
'PenInputPanel to an InkEdit control.
Dim thePenInputPanel As New PenInputPanel(theInkEdit)

'Start the Text Services Framework
thePenInputPanel.EnableTsf(True)

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

PenInputPanel, classe

Membres PenInputPanel

Microsoft.Ink, espace de noms

Partager via