Evento PenInputPanel.PanelChanged

Articolo
10/29/2008

Aggiornamento: novembre 2007

Obsoleto. Si verifica quando l'oggetto PenInputPanel modifica il tipo di pannello attualmente utilizzato per l'input. L'oggetto PenInputPanel è stato sostituito dall'oggetto Microsoft.Ink.TextInput.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Event PanelChanged As PenInputPanelChangedEventHandler
'Utilizzo
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 non supporta gli eventi.

Note

Il gestore eventi riceve un argomento di tipo PenInputPanelChangedEventArgs contenente i dati relativi a questo evento.

Quando si crea un oggetto PenInputPanel, il pannello Riconoscimento grafia è il tipo di pannello predefinito. Se il pannello viene modificato impostando la proprietà CurrentPanel prima che il pannello input penna diventi attivo per la prima volta, si verifica un evento PanelChanged.

L'evento PanelChanged non viene generato quando l'utente passa da un pannello PanelType utilizzato per l'input a più caratteri, ad esempio parole, a un pannello PanelType utilizzato per l'input di un singolo carattere.

Nota sulla sicurezza:
Se utilizzato in attendibilità parziale, questo evento richiede l'autorizzazione SecurityPermissionFlag.AllFlags, oltre alle autorizzazioni richieste dall'oggetto PenInputPanel. Per ulteriori informazioni, vedere Security and Trust.

Esempi

In questo esempio di C# viene creato un oggetto PenInputPanel, thePenInputPanel, che viene associato a un controllo InkEdit, theInkEdit. Viene quindi aggiunto un gestore eventi PanelChanged all'oggetto thePenInputPanel. Il gestore dell'oggetto PanelChanged imposta il testo del controllo InkEdit associato su una frase che contiene il nuovo tipo di pannello.

[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();
    }
}

In questo esempio di Microsoft® Visual Basic® .NET viene creato un oggetto PenInputPanel, thePenInputPanel, che viene associato a un controllo InkEdit, theInkEdit. Viene quindi aggiunto un gestore eventi PanelChanged all'oggetto thePenInputPanel. Il gestore dell'oggetto PanelChanged imposta il testo del controllo InkEdit associato su una frase che contiene il nuovo tipo di pannello.

[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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.