PenInputPanel.InputFailed, événement

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Se produit lorsque le focus d'entrée change avant que l'objet PenInputPanel ne soit en mesure d'insérer l'entrée d'utilisateur dans le contrôle attaché. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

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

Syntaxe

'Déclaration
Public Event InputFailed As PenInputPanelInputFailedEventHandler
'Utilisation
Dim instance As PenInputPanel
Dim handler As PenInputPanelInputFailedEventHandler

AddHandler instance.InputFailed, handler

public event PenInputPanelInputFailedEventHandler InputFailed

public:
 event PenInputPanelInputFailedEventHandler^ InputFailed {
    void add (PenInputPanelInputFailedEventHandler^ value);
    void remove (PenInputPanelInputFailedEventHandler^ value);
}

/** @event */
public void add_InputFailed (PenInputPanelInputFailedEventHandler value)
/** @event */
public void remove_InputFailed (PenInputPanelInputFailedEventHandler value)

JScript ne prend pas en charge les événements.

Notes

Le gestionnaire d'événements reçoit un argument de type PenInputPanelInputFailedEventArgs contenant des données concernant cet événement.

L'événement InputFailed se produit lorsque le focus d'entrée change avant que l'entrée d'utilisateur n'ait été insérée dans le contrôle attaché. Par exemple, si l'utilisateur effectue une entrée manuscrite dans le pavé d'écriture, puis clique un autre contrôle d'édition avant que le module de reconnaissance n'ait pu terminer, cet événement se déclenche.

L'utilisation du handle de fenêtre passé dans cet événement vous permet de choisir d'insérer le texte manuellement lorsque cet événement se produit.

Remarque importante :
Depuis la version Microsoft® Windows® XP Édition Tablet PC 2005, l'événement InputFailed ne s'applique plus. Le texte est toujours inséré avant que le focus ne soit modifié.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cet événement requiert l'autorisation SecurityPermissionFlag.AllFlags (page pouvant être en anglais), en plus des autorisations requises par PenInputPanel. Consultez Security and Trust.

Exemples

Cet exemple C# crée deux objets PenInputPanel, thePenInputPanel1 et thePenInputPanel2, et les attache aux contrôles TextBox (page pouvant être en anglais), textBox1 et textBox2. L'exemple ajoute un PenInputPanelInputFailedEventHandler, InputFailed_Event, à chaque objet PenInputPanel. Dans le gestionnaire d'événements, si le focus a changé, le texte est défini dans le précédent contrôle TextBox (page pouvant être en anglais) via la définition de sa propriété Text (page pouvant être en anglais).

//...

// Declare PenInputPanel objects
PenInputPanel thePenInputPanel1;
PenInputPanel thePenInputPanel2;

public Form1()
{
    // Required for Windows Form Designer support
    InitializeComponent();

    // Create, and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = new PenInputPanel(textBox1);
    thePenInputPanel2 = new PenInputPanel(textBox2);

    // Add an InputFailed event handler to each PenInputPanel
    thePenInputPanel1.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);

    thePenInputPanel2.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);
}

//...

public void InputFailed_Event(object sender,
PenInputPanelInputFailedEventArgs e)
{
    // Make sure the object that generated
    // the event is a PenInputPanel object
    if (sender is PenInputPanel)
    {
        PenInputPanel theSenderPanel = (PenInputPanel)sender;

        // Set the text in the previous control
        theSenderPanel.AttachedEditControl.Text += e.Text;
    }
}

Cet exemple Microsoft Visual Basic® .NET crée deux objets PenInputPanel, thePenInputPanel1 et thePenInputPanel2, et les attache aux contrôles TextBox (page pouvant être en anglais), textBox1 et textBox2. L'exemple ajoute un PenInputPanelInputFailedEventHandler, InputFailed_Event, à chaque objet PenInputPanel. Dans le gestionnaire d'événements, si le focus a changé, le texte est défini dans le précédent contrôle TextBox (page pouvant être en anglais) via la définition de sa propriété Text (page pouvant être en anglais).

'...

' Declare the PenInputPanel objects
Dim thePenInputPanel1 As PenInputPanel
Dim thePenInputPanel2 As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = New PenInputPanel(TextBox1)
    thePenInputPanel2 = New PenInputPanel(TextBox2)

    ' Add an InputFailed event handler to each PenInputPanel
    AddHandler thePenInputPanel1.InputFailed, AddressOf InputFailed_Event
    AddHandler thePenInputPanel2.InputFailed, AddressOf InputFailed_Event
End Sub 'New

'...

Public Sub InputFailed_Event(ByVal sender As Object, ByVal e As _
                             PenInputPanelInputFailedEventArgs)
    ' Make sure the object that generated
    ' the event is a PenInputPanel object
    If TypeOf sender Is PenInputPanel Then
        Dim thePenInputPanel As PenInputPanel = CType(sender, PenInputPanel)

        ' Set the text in the previous control
        thePenInputPanel.AttachedEditControl.Text += e.Text
    End If
End Sub 'InputFailed_Event

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.