Evento InkOverlay.SelectionChanging

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando la selezione dell'input penna all'interno del controllo sta per essere cambiata, ad esempio tramite modifiche apportate all'interfaccia utente, procedure di taglia e incolla o la proprietà Selection.

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

Sintassi

'Dichiarazione
Public Event SelectionChanging As InkOverlaySelectionChangingEventHandler
'Utilizzo
Dim instance As InkOverlay
Dim handler As InkOverlaySelectionChangingEventHandler

AddHandler instance.SelectionChanging, handler

public event InkOverlaySelectionChangingEventHandler SelectionChanging

public:
 event InkOverlaySelectionChangingEventHandler^ SelectionChanging {
    void add (InkOverlaySelectionChangingEventHandler^ value);
    void remove (InkOverlaySelectionChangingEventHandler^ value);
}

/** @event */
public void add_SelectionChanging (InkOverlaySelectionChangingEventHandler value)
/** @event */
public void remove_SelectionChanging (InkOverlaySelectionChangingEventHandler value)

JScript non supporta gli eventi.

Note

Il gestore eventi riceve un argomento di tipo InkOverlaySelectionChangingEventArgs contenente i dati relativi a questo evento.

È possibile gestire questo evento per modificare il comportamento di selezione predefinito dell'oggetto InkOverlay.

Quando si crea un delegato InkOverlaySelectionChangingEventHandler, viene identificato il metodo che gestisce l'evento. Per associare l'evento al gestore in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuova il delegato. Per motivi di prestazioni, l'interesse dell'evento predefinito è disattivato, ma viene attivato automaticamente se si aggiunge un gestore eventi.

Esempi

In questo esempio, il gestore eventi SelectionChanging impedisce la selezione di più tratti rimuovendo tutti gli oggetti tranne Stroke dalla selezione corrente.

Private Sub mInkObject_SelectionChanging(ByVal sender As Object, ByVal e As InkOverlaySelectionChangingEventArgs)
    While e.NewSelection.Count > 1
        e.NewSelection.RemoveAt(e.NewSelection.Count - 1)
    End While
End Sub

private void mInkObject_SelectionChanging(object sender, InkOverlaySelectionChangingEventArgs e)
{
    while (e.NewSelection.Count > 1)
    {
        e.NewSelection.RemoveAt(e.NewSelection.Count - 1);
    }
}

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.