PenInputPanel.PanelChanged-Ereignis

Artikel
11/26/2008

Veraltet. Tritt ein, wenn das PenInputPanel-Objekt den aktuell für die Eingabe verwendeten Bereichstyp ändert. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

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

Syntax

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

Hinweise

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

Wird ein PenInputPanel-Objekt erstellt, ist der Handschriftbereich der Standardbereichstyp. Wird der Bereich mithilfe der CurrentPanel-Eigenschaft geändert, bevor der Stifteingabebereich zum ersten Mal aktiv werden kann, wird das PanelChanged-Ereignis ausgelöst.

Das PanelChanged-Ereignis wird nicht ausgelöst, wenn der Benutzer zwischen einem für die Eingabe mehrerer Zeichen, beispielsweise für Wörter verwendeten PanelType-Bereich und einem für die Eingabe einzelner Zeichen verwendeten PanelType-Bereich wechselt.

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

Beispiele

In diesem C#-Beispiel wird das PenInputPanel-Objekt thePenInputPanel erstellt und an das InkEdit-Steuerelement theInkEdit angefügt. Anschließend wird dem thePenInputPanel ein PanelChanged-Ereignishandler angefügt. Der PanelChanged-Handler legt den Text des angefügten InkEdit-Steuerelements auf einen Satz fest, der den neuen Bereichstyp enthält.

[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 diesem Microsoft® Visual Basic® .NET-Beispiel wird ein PenInputPanel-Objekt mit dem Namen thePenInputPanel erstellt und an ein InkEdit-Steuerelement mit dem Namen theInkEdit angefügt. Anschließend wird dem thePenInputPanel ein PanelChanged-Ereignishandler angefügt. Der PanelChanged-Handler legt den Text des angefügten InkEdit-Steuerelements auf einen Satz fest, der den neuen Bereichstyp enthält.

[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

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.