PenInputPanel.DefaultPanel, propriété

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Obtient ou définit le type du panneau par défaut 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 DefaultPanel As PanelType
'Utilisation
Dim instance As PenInputPanel
Dim value As PanelType

value = instance.DefaultPanel

instance.DefaultPanel = value

public PanelType DefaultPanel { get; set; }

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

/** @property */
public PanelType get_DefaultPanel()
/** @property */
public  void set_DefaultPanel(PanelType value)

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

Valeur de propriété

Type : Microsoft.Ink.PanelType
Une des valeurs PanelType.

Notes

Remarque :
La propriété DefaultPanel ne peut pas avoir la valeur Inactive.

Le panneau Handwriting, également appelé pavé d'écriture, est l'interface utilisateur d'entrée par défaut pour un objet PenInputPanel.

Si cette propriété a la valeur Default, l'objet PenInputPanel utilise le dernier type de panneau utilisé pour tout panneau de saisie du stylet dans toute application. Si toutes les références précédentes au panneau de saisie du stylet ont été détruites dans toutes les applications actives, un nouvel objet PenInputPanel utilise le type de panneau Handwriting.

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 définition de la propriété DefaultPanel vous permet de spécifier le type de panneau qui s'affiche par défaut dans cette instance de l'objet PenInputPanel. Si la valeur de cette propriété est Handwriting ou Keyboard, à chaque fois que le panneau devient visible, les types de panneau écriture manuscrite ou clavier sont utilisés respectivement.

Si vous attachez à nouveau le PenInputPanel à un contrôle différent et modifiez la propriété DefaultPanel lorsque le focus passe au nouveau contrôle, veillez à définir la propriété DefaultPanel avant de définir la propriété AttachedEditWindow pour vous assurez que le panneau approprié s'affiche.

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 définit ensuite le clavier comme méthode d'entrée par défaut pour le panneau de saisie du stylet en affectant la valeur Keyboard à la propriété DefaultPanel.

[C#]

//...

// Declare, create, and attach a new PenInputPanel to an InkEdit control
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);

// Set the default panel to keyboard input
thePenInputPanel.DefaultPanel = PanelType.Keyboard;

Cet exemple Microsoft® Visual Basic® .NET crée un objet PenInputPanel, thePenInputPanel, et l'attache à un contrôle InkEdit, theInkEdit. Il définit alors le clavier comme méthode d'entrée par défaut pour le panneau de saisie du stylet en affectant la valeur Keyboard à la propriété DefaultPanel.

[Visual Basic]

' Declare, create, and attach a new PenInputPanel to an InkEdit control
Dim thePenInputPanel As New PenInputPanel(theInkEdit)

' Set the default panel to keyboard input
thePenInputPanel.DefaultPanel = PanelType.Keyboard

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.