PenInputPanel.InputFailed-Ereignis

Artikel
11/26/2008

Veraltet. Tritt ein, wenn sich der Eingabefokus ändert, bevor das PenInputPanel-Objekt die Benutzereingaben in das angefügte Steuerelement einfügen konnte. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Event InputFailed As PenInputPanelInputFailedEventHandler
'Usage
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 unterstützt keine Ereignisse.

Hinweise

Der Ereignishandler empfängt ein Argument vom Typ PenInputPanelInputFailedEventArgs, das Daten zu diesem Ereignis enthält.

Das InputFailed-Ereignis tritt ein, wenn sich der Eingabefokus ändert, bevor die Benutzereingaben in das angefügte Steuerelement eingefügt wurden. Dieses Ereignis wird z. B. ausgelöst, wenn der Benutzer Freihandeingaben in den Schreibblock einfügt und dann auf ein anderes Bearbeitungssteuerelement tippt, bevor das Erkennungsmodul Gelegenheit hatte, die Eingaben zu verarbeiten.

Mithilfe des durch dieses Ereignis übergebenen Fensterhandles können Sie wählen, ob Sie den Text manuell einfügen wollen, sobald dieses Ereignis eintritt.

Wichtiger Hinweis:
Ab Microsoft® Windows® XP-Tablet PC Edition 2005 ist das InputFailed-Ereignis nicht mehr gültig. Text wird immer eingefügt, bevor sich der Fokus ändert.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für dieses Ereignis die SecurityPermissionFlag.AllFlags-Berechtigung sowie die von PenInputPanel geforderten Berechtigungen erforderlich. Informationen finden Sie unter Security and Trust.

Beispiele

In diesem C#-Beispiel werden die zwei PenInputPanel-Objekte thePenInputPanel1 und thePenInputPanel2 erstellt und an die TextBox-Steuerelemente textBox1 und textBox2 angefügt. Im Beispiel wird jedem PenInputPanel-Objekt ein PenInputPanelInputFailedEventHandler für das InputFailed_Event-Ereignis hinzugefügt. Bei einer Änderung des Fokus wird im Ereignishandler der Text im vorherigen TextBox-Steuerelement festgelegt, indem die zugehörige Text-Eigenschaft festgelegt wird.

//...

// 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;
    }
}

In diesem Microsoft Visual Basic® .NET-Beispiel werden die zwei PenInputPanel-Objekte thePenInputPanel1 und thePenInputPanel2 erstellt und an die TextBox-Steuerelemente textBox1 und textBox2 angefügt. Im Beispiel wird jedem PenInputPanel-Objekt ein PenInputPanelInputFailedEventHandler für das InputFailed_Event-Ereignis hinzugefügt. Bei einer Änderung des Fokus wird im Ereignishandler der Text im vorherigen TextBox-Steuerelement festgelegt, indem die zugehörige Text-Eigenschaft festgelegt wird.

'...

' 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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.