Metodo PenInputPanel.MoveTo

Articolo
10/29/2008

Aggiornamento: novembre 2007

Obsoleto. Imposta la posizione dell'oggetto PenInputPanel su una posizione dello schermo definita. L'oggetto PenInputPanel è stato sostituito dall'oggetto Microsoft.Ink.TextInput.

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

Sintassi

'Dichiarazione
<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 _
)
'Utilizzo
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
)

Parametri

left
Tipo: System.Int32
Nuova posizione sull'asse X del bordo sinistro dell'oggetto PenInputPanel, nelle coordinate dello schermo.

top
Tipo: System.Int32
Nuova posizione sull'asse Y del bordo superiore dell'oggetto PenInputPanel, nelle coordinate dello schermo.

Note

Il metodo MoveTo provoca un errore se il controllo a cui è associato l'oggetto PenInputPanel non dispone dello stato attivo. Questo metodo può essere chiamato in modo sicuro se il pannello input penna non è visibile, finché il controllo associato dispone dello stato attivo.

Se la nuova posizione fa in modo che il pannello venga visualizzato all'esterno del limite dell'area di lavoro dello schermo, il pannello viene spostato verso il centro dell'area di lavoro in modo che i bordi del pannello siano adiacenti ai bordi più vicini dello schermo.

Per eseguire l'override in modo esplicito del comportamento di posizionamento automatico dell'oggetto PenInputPanel, utilizzare le proprietà Left e Top dell'oggetto PenInputPanel per determinarne la posizione corrente. Se l'oggetto PenInputPanel si trova in una sezione dello schermo che deve essere visibile, utilizzare il metodo MoveTo per riposizionare l'oggetto PenInputPanel.

È inoltre possibile eseguire l'override del comportamento di posizionamento automatico dell'oggetto PenInputPanel attraverso il monitoraggio delle proprietà Left e Top dell'oggetto PenInputPanelMovingEventArgs durante un evento PanelMoving. Se l'oggetto PenInputPanel si trova in una sezione dello schermo che deve essere visibile, utilizzare il metodo MoveTo per riposizionare l'oggetto PenInputPanel.

Nota sulla sicurezza:
Se utilizzato in attendibilità parziale, questo metodo 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 associato un oggetto PenInputPanel, thePenInputPanel, a un controllo InkEdit, theInkEdit. Viene aggiunto un gestore eventi VisibleChanged, VisibleChanged_Event, al form dell'oggetto PenInputPanel. Nel gestore eventi, se l'oggetto PenInputPanel è visibile, la relativa posizione viene modificata in base alle coordinate dello schermo (100, 100), mediante la chiamata al metodo 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);
        }
    }
}

In questo esempio di Microsoft® Visual Basic® .NET viene associato un oggetto PenInputPanel, thePenInputPanel, a un controllo InkEdit, theInkEdit. Viene aggiunto un gestore eventi VisibleChanged, VisibleChanged_Event, al form dell'oggetto PenInputPanel. Nel gestore eventi, se l'oggetto PenInputPanel è visibile, la relativa posizione viene modificata in base alle coordinate dello schermo (100, 100), mediante la chiamata al metodo 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

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.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

PenInputPanel Classe

Membri PenInputPanel

Spazio dei nomi Microsoft.Ink

Condividi tramite