Proprietà PenInputPanel.CurrentPanel

Articolo
10/29/2008

Aggiornamento: novembre 2007

Obsoleto. Ottiene o imposta il tipo di pannello attualmente in uso per l'input penna all'interno dell'oggetto PenInputPanel. L'oggetto PenInputPanel è stato sostituito dall'oggetto Microsoft.Ink.TextInput.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property CurrentPanel As PanelType
'Utilizzo
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)

Valore proprietà

Tipo: Microsoft.Ink.PanelType
Uno dei valori PanelType che rappresentano il tipo di pannello attualmente utilizzato per l'input all'interno dell'oggetto PenInputPanel. Il tipo di pannello Handwriting è il valore predefinito.

Note

Nota

La proprietà CurrentPanel non può essere impostata sull'oggetto Default o Inactive.

Quando si crea un oggetto PenInputPanel, il pannello Handwriting, anche noto come riquadro scrittura, rappresenta l'interfaccia utente di input predefinita.

Se il pannello viene modificato impostando la proprietà CurrentPanel prima che l'oggetto PenInputPanel diventi attivo per la prima volta, si verifica un evento PanelChanged.

La proprietà CurrentPanel può essere impostata solo sul valore Handwriting o Keyboard dell'enumerazione PanelType. La proprietà CurrentPanel non può mai essere impostata sull'oggetto Default o Inactive.

La proprietà CurrentPanel restituisce il valore dell'enumerazione Inactive se la finestra del pannello è associata a un'altra istanza dell'oggetto PenInputPanel. L'impostazione della proprietà CurrentPanel genera un'eccezione se il pannello è inattivo o se il tipo di pannello non è valido.

Nota sulla sicurezza:
Se utilizzata in attendibilità parziale, questa proprietà richiede l'autorizzazione SecurityPermissionFlag.AllFlags, oltre alle autorizzazioni richieste dall'oggetto PenInputPanel. Per ulteriori informazioni, vedere Security and Trust.

Esempi

In questo esempio di C# viene creato un oggetto PenInputPanel, thePenInputPanel, che viene associato a un controllo InkEdit, theInkEdit. Inoltre, viene associato un gestore eventi VisibleChanged, VisibleChanged_Event all'oggetto thePenInputPanel. Il gestore eventi impone al pannello input penna di visualizzare il pannello della tastiera quando diventa visibile impostando la proprietà CurrentPanel su Keyboard.

[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 questo esempio di Microsoft® Visual Basic® .NET viene creato un oggetto PenInputPanel, thePenInputPanel, che viene associato a un controllo InkEdit, theInkEdit. Inoltre, viene associato un gestore eventi VisibleChanged, VisibleChanged_Event all'oggetto thePenInputPanel. Il gestore eventi impone al pannello input penna di visualizzare il pannello della tastiera quando diventa visibile impostando la proprietà CurrentPanel su Keyboard.

[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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.