Proprietà PenInputPanel.Top

Articolo
10/29/2008

Aggiornamento: novembre 2007

Obsoleto. Ottiene la posizione verticale, o sull'asse Y, del bordo superiore dell'oggetto PenInputPanel, nelle coordinate dello schermo. 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 ReadOnly Property Top As Integer
'Utilizzo
Dim instance As PenInputPanel
Dim value As Integer

value = instance.Top

public int Top { get; }

public:
property int Top {
    int get ();
}

/** @property */
public int get_Top()

public function get Top () : int

Valore proprietà

Tipo: System.Int32
Posizione verticale, o sull'asse Y, del bordo superiore dell'oggetto PenInputPanel, nelle coordinate dello schermo.

Note

Per eseguire l'override in modo esplicito del comportamento di posizionamento automatico dell'oggetto PenInputPanel, utilizzare le proprietà Left e Top dell'oggetto per determinare la posizione corrente del pannello input penna.

È inoltre possibile eseguire l'override del comportamento di posizionamento automatico dell'oggetto PenInputPanel attraverso l'ascolto delle proprietà Left e Top dell'oggetto PenInputPanelMovingEventArgs durante un evento PanelMoving.

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. Viene quindi associato un gestore eventi VisibleChanged, VisibleChanged_Event. Il gestore eventi utilizza la proprietà Top per aggiungere una frase al contenuto dell'oggetto theInkEdit, in cui viene indicato il punto in cui si trova il bordo superiore dell'oggetto PenInputPanel, nelle coordinate dello schermo.

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

        // When the panel has become visible...
        if (e.NewVisibility)
        {
            // Display the top edge of the panel
            // in the attached edit control
            theSenderPanel.AttachedEditControl.Text +=
                    "The top edge of the panel is at ";
            theSenderPanel.AttachedEditControl.Text += theSenderPanel.Top.ToString();
            theSenderPanel.AttachedEditControl.Text += " pixels.\n";
        }
    }
}

In questo esempio di Microsoft® Visual Basic® .NET viene creato un oggetto PenInputPanel, thePenInputPanel, che viene associato a un controllo InkEdit, theInkEdit. Viene quindi associato un gestore eventi VisibleChanged, VisibleChanged_Event. Il gestore eventi utilizza la proprietà Top per aggiungere una frase al contenuto dell'oggetto theInkEdit, in cui viene indicato il punto in cui si trova il bordo superiore dell'oggetto PenInputPanel, nelle coordinate dello schermo.

[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(ByVal sender As Object, ByVal 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)

        ' When the panel has become visible...
        If e.NewVisibility Then
            ' Display the top edge of the panel
            ' in the attached edit control
            theSenderPanel.AttachedEditControl.Text += _
                     "The top edge of the panel is at "

            theSenderPanel.AttachedEditControl.Text += _
                     theSenderPanel.Top.ToString()

            theSenderPanel.AttachedEditControl.Text += _
                     " pixels." + ControlChars.Lf
        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.