PenInputPanel.InputFailed (Evento)

Artículo
10/28/2008

Actualización: noviembre 2007

Obsoleto. Se produce cuando el foco de entrada cambia antes de que el objeto PenInputPanel pueda insertar los datos proporcionados por el usuario en el control asociado. PenInputPanel se ha reemplazado por Microsoft.Ink.TextInput.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Event InputFailed As PenInputPanelInputFailedEventHandler
'Uso
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 no admite eventos.

Comentarios

El controlador de eventos recibe un argumento de tipo PenInputPanelInputFailedEventArgs que contiene datos sobre este evento.

El evento InputFailed se produce cuando el foco de entrada cambia antes de que los datos proporcionados por el usuario se inserten en el control asociado. Por ejemplo, este evento se desencadena si el usuario escribe la entrada manuscrita en el panel de escritura y, a continuación, puntea otro control de edición antes de que el reconocedor haya tenido tiempo de finalizar.

Si usa el identificador de ventana pasado en este evento, puede elegir insertar el texto manualmente cuando este evento se produce.

Nota importante:
Si se inicia con Microsoft® Windows® XP Tablet PC Edition 2005, el evento InputFailed ya no se aplica. El texto se inserta siempre antes de que el foco cambie.

Nota de seguridad:
Si se usa en entornos de confianza parcial, este evento necesita el permiso SecurityPermissionFlag.AllFlags, además de los permisos que requiere PenInputPanel. Vea Security and Trust.

Ejemplos

En este ejemplo de C# se crean dos objetos PenInputPanel, thePenInputPanel1 y thePenInputPanel2, y se asocian a los controles TextBoxtextBox1 y textBox2. En el ejemplo se agrega PenInputPanelInputFailedEventHandler, InputFailed_Event, a cada objeto PenInputPanel. En el controlador de eventos, si se modifica el foco, el texto se establece en el control TextBox al establecer su propiedad Text.

//...

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

En este ejemplo de Microsoft Visual Basic® .NET se crean dos objetos PenInputPanelthePenInputPanel1 y thePenInputPanel2, y se asocian a los controles TextBoxtextBox1 y textBox2. En el ejemplo se agrega PenInputPanelInputFailedEventHandler, InputFailed_Event, a cada objeto PenInputPanel. En el controlador de eventos, si se modifica el foco, el texto se establece en el control TextBox al establecer su propiedad Text.

'...

' 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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.