PenInputPanel.DefaultPanel-Eigenschaft

Artikel
11/26/2008

Veraltet. Ruft den im PenInputPanel-Objekt für die Eingabe verwendeten Standardbereichstyp ab oder legt diesen fest. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

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

Syntax

'Declaration
Public Property DefaultPanel As PanelType
'Usage
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)

Eigenschaftenwert

Typ: Microsoft.Ink.PanelType
Einer der PanelType-Werte.

Hinweise

Hinweis

Die DefaultPanel-Eigenschaft kann nicht auf Inactive festgelegt werden.

Der Handwriting-Bereich – auch als Schreibblock bezeichnet – ist der Standardeingabetyp für ein PenInputPanel-Objekt.

Ist der Wert dieser Eigenschaft Default, dann verwendet das PenInputPanel-Objekt den Bereichstyp, der für einen Stifteingabebereich in einer Anwendung zuletzt verwendet wurde. Wenn alle vorherigen Verweise auf den Stifteingabebereich in allen aktiven Anwendungen gelöscht wurden, verwendet ein neues PenInputPanel-Objekt den Handwriting-Bereichstyp.

Wurde der Bereich mithilfe der CurrentPanel-Eigenschaft geändert, bevor das PenInputPanel-Objekt zum ersten Mal aktiv werden konnte, wird das PanelChanged-Ereignis ausgelöst.

Die Festlegung der DefaultPanel-Eigenschaft ermöglicht es Ihnen anzugeben, welcher Bereichstyp standardmäßig in dieser Instanz des PenInputPanel-Objekts angezeigt wird. Ist der Wert dieser Eigenschaft auf Handwriting oder Keyboard festgelegt, verwendet es jedes Mal den Handschrift- bzw. den Tastaturbereichstyp, sobald es sichtbar gemacht wird.

Wenn Sie den PenInputPanel einem anderen Steuerelement zuordnen und die DefaultPanel-Eigenschaft ändern, sobald der Fokus zu dem neuen Steuerelement wechselt, dann achten Sie darauf, die DefaultPanel-Eigenschaft vor der AttachedEditWindow-Eigenschaft festzulegen, um sicherzustellen, dass der korrekte Bereich angezeigt wird.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Eigenschaft 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. Dann wird die Tastatur auf die Standardeingabemethode für den Stifteingabebereich festgelegt, indem die DefaultPanel-Eigenschaft auf Keyboard festgelegt wird.

[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;

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. Dann wird die Tastatur auf die Standardeingabemethode für den Stifteingabebereich festgelegt, indem die DefaultPanel-Eigenschaft auf Keyboard festgelegt wird.

[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

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.