PenInputPanel.CurrentPanel-Eigenschaft

Artikel
11/26/2008

Veraltet. Ruft den aktuell im PenInputPanel-Objekt für die Eingabe verwendeten Bereichstyp 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 CurrentPanel As PanelType
'Usage
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)

Eigenschaftenwert

Typ: Microsoft.Ink.PanelType
Einer der PanelType-Werte, der den gerade im PenInputPanel-Objekt für die Eingabe verwendeten Bereichstyp darstellt. Der Bereichstyp Handwriting ist der Standardwert.

Hinweise

Hinweis

Die CurrentPanel-Eigenschaft kann nicht auf Default oder Inactive festgelegt werden.

Wenn Sie ein PenInputPanel-Objekts erstellen, ist der Handwriting-Bereich – auch als Schreibblock bezeichnet – der Standardeingabetyp.

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

Die CurrentPanel-Eigenschaft kann nur auf den Wert Handwriting oder den Wert Keyboard der PanelType-Enumeration festgelegt werden. Die CurrentPanel-Eigenschaft kann nie auf den Wert Default oder den Wert Inactive festgelegt werden.

Die CurrentPanel-Eigenschaft gibt den Wert der Inactive-Enumeration zurück, wenn das Bereichsfenster einer anderen Instanz des PenInputPanel-Objekts zugeordnet ist. Wenn die CurrentPanel-Eigenschaft festgelegt wird, während der Bereich inaktiv oder der Bereichstyp ungültig ist, wird eine Ausnahme ausgelöst.

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 thePenInputPanel der VisibleChanged-Ereignishandler VisibleChanged_Event angefügt. Indem der Ereignishandler die CurrentPanel-Eigenschaft auf Keyboard festlegt, zwingt er den Stifteingabebereich, den Tastaturbereich anzuzeigen, sobald er sichtbar wird.

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

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 thePenInputPanel der VisibleChanged-Ereignishandler VisibleChanged_Event angefügt. Indem der Ereignishandler die CurrentPanel-Eigenschaft auf Keyboard festlegt, zwingt er den Stifteingabebereich, den Tastaturbereich anzuzeigen, sobald er sichtbar wird.

[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

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.