PenInputPanel.CurrentPanel, propriété

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Obtient ou définit le type du panneau actuellement utilisé pour la saisie dans l'objet PenInputPanel. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

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

Syntaxe

'Déclaration
Public Property CurrentPanel As PanelType
'Utilisation
Dim instance As PenInputPanel
Dim value As PanelType

value = instance.CurrentPanel

instance.CurrentPanel = value

public PanelType CurrentPanel { get; set; }

public:
property PanelType CurrentPanel {
    PanelType get ();
    void set (PanelType value);
}

/** @property */
public PanelType get_CurrentPanel()
/** @property */
public  void set_CurrentPanel(PanelType value)

public function get CurrentPanel () : PanelType
public function set CurrentPanel (value : PanelType)

Valeur de propriété

Type : Microsoft.Ink.PanelType
L'une des valeurs PanelType représentant le type de panneau actuellement utilisé pour la saisie dans l'objet PenInputPanel. Le type de panneau Handwriting représente la valeur par défaut.

Notes

Remarque :
La propriété CurrentPanel ne peut pas avoir la valeur Default ni Inactive.

Lorsque vous créez un objet PenInputPanel, le panneau Handwriting, également appelé pavé d'écriture, est l'interface utilisateur d'entrée par défaut.

Si vous modifiez le panneau en définissant la propriété CurrentPanel avant la première activation de l'objet PenInputPanel, un événement PanelChanged se produit.

La propriété CurrentPanel peut uniquement avoir la valeur Handwriting ou la valeur Keyboard de l'énumération PanelType. La valeur Default ou Inactive ne peuvent pas être affectées à la propriété CurrentPanel.

La propriété CurrentPanel retourne la valeur d'énumération Inactive si la fenêtre de panneau est associée à une autre instance de l'objet PenInputPanel. La définition de la propriété CurrentPanel génère une exception si le panneau est inactif ou si le type de panneau n'est pas valide.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette méthode 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. Il attache un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au thePenInputPanel Le gestionnaire d'événements force le panneau de saisie du stylet à afficher le panneau de clavier lorsqu'il devient visible, en affectant la valeur Keyboard à la propriété CurrentPanel.

[C#]

//...

// Declare 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 VisibleChanged event handler
    thePenInputPanel.VisibleChanged +=
        new PenInputPanelVisibleChangedEventHandler(VisibleChanged_Event);
}

//...

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

        // If the panel has become visible...
        if (e.NewVisibility)
        {
            // Always default to keyboard input
            if (theSenderPanel.CurrentPanel == PanelType.Handwriting)
            {
                theSenderPanel.CurrentPanel = PanelType.Keyboard;
            }
        }
    }
}

Cet exemple Microsoft® Visual Basic® .NET crée un objet PenInputPanel, thePenInputPanel, et l'attache à un contrôle InkEdit, theInkEdit. Il attache un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, à thePenInputPanel Le gestionnaire d'événements force le panneau de saisie du stylet à afficher le panneau de clavier lorsqu'il devient visible, en affectant la valeur Keyboard à la propriété CurrentPanel.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    ' Required for Windows Form Designer support
    InitializeComponent()

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

    ' Add a VisibleChanged event handler
    AddHandler thePenInputPanel.VisibleChanged, _
               AddressOf VisibleChanged_Event
End Sub 'New


'...
Public Sub VisibleChanged_Event(sender As Object, e As _
                                PenInputPanelVisibleChangedEventArgs)
    ' 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)

       ' If the panel has become visible...
       If e.NewVisibility Then
          ' Always default to keyboard input
          If theSenderPanel.CurrentPanel = PanelType.Handwriting Then
             theSenderPanel.CurrentPanel = PanelType.Keyboard
          End If
       End If
    End If
End Sub 'VisibleChanged_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.