PenInputPanel.Top, propriété

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Obtient l'emplacement vertical, ou axe des ordonnées, du bord supérieur de l'objet PenInputPanel, en coordonnées d'écran. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Top As Integer
'Utilisation
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

Valeur de propriété

Type : System.Int32
Emplacement vertical, ou axe des ordonnées, du bord supérieur de l'objet PenInputPanel, en coordonnées d'écran.

Notes

Pour remplacer explicitement le comportement de positionnement automatique de l'objet PenInputPanel, utilisez les propriétés Left et Top de l'objet afin de déterminer la position actuelle du panneau de saisie du stylet.

Vous pouvez également remplacer le comportement de positionnement automatique de l'objet PenInputPanel en écoutant les propriétés Left et Top de l'objet PenInputPanelMovingEventArgs pendant un événement PanelMoving.

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. Un gestionnaire d'événements VisibleChanged, VisibleChanged_Event est ensuite ajouté. Le gestionnaire d'événements utilise la propriété Top pour ajouter une phrase au contenu de theInkEdit, en indiquant l'emplacement du bord supérieur de l'objet PenInputPanel, en coordonnées d'écran.

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

Cet exemple Microsoft® Visual Basic® .NET crée un objet PenInputPanel, thePenInputPanel, et l'attache à un contrôle InkEdit, theInkEdit. Un gestionnaire d'événements VisibleChanged, VisibleChanged_Event est ensuite ajouté. Le gestionnaire d'événements utilise la propriété Top pour ajouter une phrase au contenu de theInkEdit, en indiquant l'emplacement du bord supérieur de l'objet PenInputPanel, en coordonnées d'écran.

[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

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.