PenInputPanel.PanelChanged, événement

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Se produit lorsque l'objet PenInputPanel modifie le type de panneau actuellement utilisé pour la saisie. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Event PanelChanged As PenInputPanelChangedEventHandler
'Utilisation
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 ne prend pas en charge les événements.

Notes

Le gestionnaire d'événements reçoit un argument de type PenInputPanelChangedEventArgs contenant des données concernant cet événement.

Lors de la création d'un objet PenInputPanel, le panneau Écriture manuscrite est le type de panneau par défaut. Si le panneau est modifié en définissant la propriété CurrentPanel avant que le panneau de saisie du stylet ne devienne actif pour la première fois, un événement PanelChanged se produit.

L'événement PanelChanged n'est pas déclenché lorsque l'utilisateur passe d'un panneau PanelType utilisé pour la saisie de caractères multiples, telle que des mots, et un panneau PanelType utilisé pour la saisie de caractères uniques.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cet événement requiert l'autorisation SecurityPermissionFlag.AllFlags (page pouvant être en anglais), en plus des autorisations requises par PenInputPanel. Pour plus d'informations, consultez Security and Trust.

Exemples

Cet exemple C# crée un objet PenInputPanel, thePenInputPanel et l'attache à un contrôle InkEdit, theInkEdit. Un gestionnaire d'événements PanelChanged est ensuite ajouté au thePenInputPanel. Le gestionnaire PanelChanged affecte le texte du contrôle InkEdit attaché à une phrase contenant le nouveau type de panneau.

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

Cet exemple Microsoft® Visual Basic® .NET crée un objet PenInputPanel, thePenInputPanel, et l'attache à un contrôle InkEdit, theInkEdit. Un gestionnaire d'événements PanelChanged est ensuite ajouté au thePenInputPanel. Le gestionnaire PanelChanged affecte le texte du contrôle InkEdit attaché à une phrase contenant le nouveau type de panneau.

[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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.