PenInputPanel.MoveTo-Methode

Artikel
10/28/2008

Veraltet. Legt die Position des PenInputPanel-Objekts auf eine definierte Position auf dem Bildschirm fest. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<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 _
)
'Usage
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
)

Parameter

left
Typ: System.Int32
Die neue x-Achsenposition am linken Rand des PenInputPanel-Objekts in Bildschirmkoordinaten.

top
Typ: System.Int32
Die neue x-Achsenposition am oberen Rand des PenInputPanel-Objekts in Bildschirmkoordinaten.

Hinweise

Die MoveTo-Methode verursacht einen Fehler, wenn das Steuerelement, dem das PenInputPanel-Objekt zugeordnet ist, nicht den Fokus besitzt. Diese Methode kann risikolos aufgerufen werden, wenn der Stifteingabebereich nicht sichtbar ist, sofern das zugeordnete Steuerelement den Fokus besitzt.

Wenn die neue Position dazu führt, dass der Bereich außerhalb der Begrenzungen des Arbeitsbereichs des Bildschirms erscheinen würde, wird der Bereich so weit in Richtung des Zentrums des Arbeitsbereichs verschoben, bis die Ränder des Bereichs neben dem nächstliegenden Rand des Bildschirms angeordnet sind.

Sie können dieses automatische Positionierungsverhalten des PenInputPanel-Objekts explizit überschreiben, indem Sie mithilfe der Left-Eigenschaft und der Top-Eigenschaft des PenInputPanel-Objekts dessen aktuelle Position festlegen. Wenn sich das PenInputPanel-Objekt in einem Abschnitt des Bildschirms befindet, der sichtbar sein soll, ändern Sie mithilfe der MoveTo-Methode die Position des PenInputPanel-Objekts.

Sie können das automatische Positionierungsverhalten des PenInputPanel-Objekts auch überschreiben, indem Sie die Left-Eigenschaft und die Top-Eigenschaft des PenInputPanelMovingEventArgs-Objekts während eines PanelMoving-Ereignisses überwachen. Wenn sich das PenInputPanel-Objekt in einem Abschnitt des Bildschirms befindet, der sichtbar sein soll, ändern Sie mithilfe der MoveTo-Methode die Position des PenInputPanel-Objekts.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Methode 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 an das InkEdit-Steuerelement theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt sichtbar ist, wird im Ereignishandler seine Position auf die Bildschirmkoordinaten (100, 100) geändert, indem die MoveTo-Methode aufgerufen wird.

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

In diesem Microsoft® Visual Basic® .NET-Beispiel wird das PenInputPanel-Objekt thePenInputPanel an das InkEdit-Steuerelement theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt sichtbar ist, wird im Ereignishandler seine Position auf die Bildschirmkoordinaten (100, 100) geändert, indem die MoveTo-Methode aufgerufen wird.

[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

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

PenInputPanel-Klasse

PenInputPanel-Member

Microsoft.Ink-Namespace

Freigeben über