PenInputPanel.MoveTo, méthode

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Affecte à l'objet PenInputPanel une position d'écran définie. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

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

Syntaxe

'Déclaration
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub MoveTo ( _
    left As Integer, _
    top As Integer _
)
'Utilisation
Dim instance As PenInputPanel
Dim left As Integer
Dim top As Integer

instance.MoveTo(left, top)

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public void MoveTo(
    int left,
    int top
)

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public:
void MoveTo(
    int left, 
    int top
)

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public void MoveTo(
    int left,
    int top
)

public function MoveTo(
    left : int, 
    top : int
)

Paramètres

left
Type : System.Int32
Nouvelle position sur l'axe des abscisses du bord gauche de l'objet PenInputPanel, en coordonnées d'écran.

top
Type : System.Int32
Nouvelle position sur l'axe des ordonnées du bord supérieur de l'objet PenInputPanel, en coordonnées d'écran.

Notes

La méthode MoveTo provoque une erreur si le contrôle auquel l'objet PenInputPanel est attaché n'a pas de focus. Cette méthode peut être appelée sans risque si le panneau de saisie du stylet n'est pas visible et tant que le contrôle attaché a le focus.

Si la nouvelle position provoque l'affichage du panneau à l'extérieur de la limite de la zone de travail de l'écran, le panneau est déplacé vers le centre de la zone de travail afin que ses bords soient adjacents aux bords les plus proches de l'écran.

Pour remplacer explicitement le comportement de positionnement automatique de l'objet PenInputPanel, utilisez les propriétés Left et Top de l'objet PenInputPanel afin de déterminer sa position actuelle. Si le PenInputPanel se trouve sur une section de l'écran qui doit être visible, utilisez la méthode MoveTo pour déplacer le PenInputPanel.

Vous pouvez également remplacer le comportement de positionnement automatique de l'objet PenInputPanel en contrôlant les propriétés Left et Top de l'objet PenInputPanelMovingEventArgs pendant un événement PanelMoving. Si le PenInputPanel se trouve sur une section de l'écran qui doit être visible, utilisez la méthode MoveTo pour déplacer le PenInputPanel.

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# attache un objet PenInputPanel, thePenInputPanel à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel est visible, sa position est exprimée en coordonnées d'écran (100, 100) suite à l'appel à la méthode MoveTo.

[C#]

//...

// Delcare 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 PenInputPanelVisibleChanged 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)
        {
            // Move the pen input panel to
            // screen position (100, 100)
            theSenderPanel.MoveTo(100, 100);
        }
    }
}

Cet exemple Microsoft® Visual Basic® .NET attache un objet PenInputPanel, thePenInputPanel, à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel est visible, sa position est exprimée en coordonnées d'écran (100, 100) suite à l'appel à la méthode MoveTo.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = New PenInputPanel(theInkEdit)

    ' Add a PenInputPanelVisibleChanged 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
          ' Move the pen input panel to
          ' screen position 100, 100
            theSenderPanel.MoveTo(100, 100)
       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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

PenInputPanel, classe

Membres PenInputPanel

Microsoft.Ink, espace de noms

Partager via