GiveFeedbackEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornisce i dati per l'evento GiveFeedback, che si verifica durante un'operazione di trascinamento.

public ref class GiveFeedbackEventArgs : EventArgs

public class GiveFeedbackEventArgs : EventArgs

type GiveFeedbackEventArgs = class
    inherit EventArgs

Public Class GiveFeedbackEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

GiveFeedbackEventArgs

Esempio

Nell'esempio seguente viene illustrata un'operazione di trascinamento della selezione tra due controlli ListBox. Nell'esempio viene chiamato il metodo DoDragDrop all'avvio dell'azione di trascinamento. L'azione di trascinamento inizia se il mouse è stato spostato più di SystemInformation.DragSize dalla posizione del mouse durante l'evento MouseDown. Il metodo IndexFromPoint viene utilizzato per determinare l'indice dell'elemento da trascinare durante l'evento MouseDown.

L'esempio illustra anche l'uso di cursori personalizzati per l'operazione di trascinamento della selezione. Nell'esempio si presuppone che nella directory dell'applicazione esistano due file di cursore, 3dwarro.cur e 3dwno.cur, rispettivamente per i cursori di trascinamento e senza rilascio personalizzati. I cursori personalizzati verranno utilizzati se è selezionata la UseCustomCursorsCheckCheckBox. I cursori personalizzati vengono impostati nel gestore eventi GiveFeedback.

Lo stato della tastiera viene valutato nel gestore eventi DragOver per il ListBoxdestro per determinare quale operazione di trascinamento si baserà sullo stato dei tasti MAIUSC, CTRL, ALT o CTRL+ALT. La posizione nel ListBox in cui si verifica l'eliminazione viene determinata anche durante l'evento DragOver. Se i dati da eliminare non sono un String, il DragEventArgs.Effect è impostato su DragDropEffects.None. Infine, lo stato del rilascio viene visualizzato nel DropLocationLabelLabel.

I dati da eliminare per il ListBox corretto sono determinati nel gestore eventi DragDrop e il valore String viene aggiunto nella posizione appropriata nel ListBox. Se l'operazione di trascinamento si sposta all'esterno dei limiti del form, l'operazione di trascinamento della selezione viene annullata nel gestore eventi QueryContinueDrag.

Questo estratto di codice illustra l'uso della classe GiveFeedbackEventArgs. Vedere il metodo DoDragDrop per l'esempio di codice completo.

void ListDragSource_GiveFeedback( Object^ /*sender*/, System::Windows::Forms::GiveFeedbackEventArgs^ e )
{
   // Use custom cursors if the check box is checked.
   if ( UseCustomCursorsCheck->Checked )
   {
      // Sets the custom cursor based upon the effect.
      e->UseDefaultCursors = false;
      if ( (e->Effect & DragDropEffects::Move) == DragDropEffects::Move )
                  ::Cursor::Current = MyNormalCursor;
      else
                  ::Cursor::Current = MyNoDropCursor;
   }
}

private void ListDragSource_GiveFeedback(object sender, GiveFeedbackEventArgs e)
{
    // Use custom cursors if the check box is checked.
    if (UseCustomCursorsCheck.Checked)
    {
        // Sets the custom cursor based upon the effect.
        e.UseDefaultCursors = false;
        if ((e.Effect & DragDropEffects.Move) == DragDropEffects.Move)
            Cursor.Current = MyNormalCursor;
        else
            Cursor.Current = MyNoDropCursor;
    }
}

Private Sub ListDragSource_GiveFeedback(ByVal sender As Object, ByVal e As GiveFeedbackEventArgs) Handles ListDragSource.GiveFeedback
    ' Use custom cursors if the check box is checked.
    If (UseCustomCursorsCheck.Checked) Then

        ' Set the custom cursor based upon the effect.
        e.UseDefaultCursors = False
        If ((e.Effect And DragDropEffects.Move) = DragDropEffects.Move) Then
            Cursor.Current = MyNormalCursor
        Else
            Cursor.Current = MyNoDropCursor
        End If
    End If

End Sub

Commenti

L'evento GiveFeedback si verifica durante un'operazione di trascinamento. Consente all'origine di un evento di trascinamento di modificare l'aspetto del puntatore del mouse per fornire all'utente feedback visivo durante un'operazione di trascinamento della selezione. Un oggetto GiveFeedbackEventArgs specifica il tipo di operazione di trascinamento della selezione e indica se vengono utilizzati i cursori predefiniti.

Per informazioni sul modello di evento, vedere Gestione e generazione di eventi.

Costruttori

GiveFeedbackEventArgs(DragDropEffects, Boolean, Bitmap, Point, Boolean)	Inizializza una nuova istanza della classe GiveFeedbackEventArgs.
GiveFeedbackEventArgs(DragDropEffects, Boolean)	Inizializza una nuova istanza della classe GiveFeedbackEventArgs.

Proprietà

CursorOffset	Ottiene o imposta l'offset del cursore dell'immagine di trascinamento.
DragImage	Ottiene o imposta la bitmap dell'immagine di trascinamento.
Effect	Ottiene il feedback dell'operazione di trascinamento della selezione visualizzato.
UseDefaultCursors	Ottiene o imposta un valore che indica se l'operazione di trascinamento deve utilizzare i cursori predefiniti associati agli effetti di trascinamento della selezione.
UseDefaultDragImage	Ottiene o imposta un valore che indica se viene utilizzata un'immagine di trascinamento della finestra a più livelli.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)