PenInputPanel.PanelChanged (Evento)

Artículo
11/26/2008

Actualización: noviembre 2007

Obsoleto. Se produce cuando los objetos PenInputPanel cambian el tipo de panel que se está usando actualmente para la entrada. 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 PanelChanged As PenInputPanelChangedEventHandler
'Uso
Dim instance As PenInputPanel
Dim handler As PenInputPanelChangedEventHandler

AddHandler instance.PanelChanged, handler

public event PenInputPanelChangedEventHandler PanelChanged

public:
 event PenInputPanelChangedEventHandler^ PanelChanged {
    void add (PenInputPanelChangedEventHandler^ value);
    void remove (PenInputPanelChangedEventHandler^ value);
}

/** @event */
public void add_PanelChanged (PenInputPanelChangedEventHandler value)
/** @event */
public void remove_PanelChanged (PenInputPanelChangedEventHandler value)

JScript no admite eventos.

Comentarios

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

Al crear un objeto PenInputPanel, el panel de escritura a mano es el tipo de panel predeterminado. Si el panel se cambia estableciendo la propiedad CurrentPanel antes de que el panel de entrada manuscrita se active por primera vez, se produce un evento PanelChanged.

El evento PanelChanged no se provoca cuando el usuario cambia entre un panel PanelType para entradas de varios caracteres, por ejemplo palabras, y un panel PanelType para entradas de carácter único.

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 para obtener más información.

Ejemplos

En este ejemplo de C# se crea un objeto PenInputPanel, thePenInputPanel, y se asocia a un control InkEdit, theInkEdit. A continuación, se agrega un controlador de eventos PanelChanged a thePenInputPanel. El controlador PanelChanged establece el texto del control InkEdit asociado en una oración que contiene el nuevo tipo de panel.

[C#]

//...

// Delcare the PenInputPanel object
PenInputPanel thePenInputPanel;

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

    // Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = new PenInputPanel(theInkEdit);

    // Add a PanelChanged event handler
    thePenInputPanel.PanelChanged +=
        new PenInputPanelChangedEventHandler(PanelChanged_Event);
}

//...

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

        theSenderPanel.AttachedEditControl.Text = "The panel has changed to ";
        theSenderPanel.AttachedEditControl.Text += e.NewPanelType.ToString();
    }
}

En este ejemplo de Microsoft® Visual Basic® .NET se crea un objeto PenInputPanel, thePenInputPanel, y se asocia a un control InkEdit, theInkEdit. A continuación, se agrega un controlador de eventos PanelChanged a thePenInputPanel. El controlador PanelChanged establece el texto del control InkEdit asociado en una oración que contiene el nuevo tipo de panel.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

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

    ' Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = New PenInputPanel(theInkEdit)

   ' Add a PanelChanged event handler
   AddHandler thePenInputPanel.PanelChanged, AddressOf PanelChanged_Event
End Sub 'New

'...

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

        theSenderPanel.AttachedEditControl.Text = "The panel has changed to "
        theSenderPanel.AttachedEditControl.Text += e.NewPanelType.ToString
    End If
End Sub 'PanelChanged_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.