GiveFeedbackEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Daten für das GiveFeedback-Ereignis bereit, das während eines Ziehvorgangs eintritt.

public ref class GiveFeedbackEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class GiveFeedbackEventArgs : EventArgs

public class GiveFeedbackEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type GiveFeedbackEventArgs = class
    inherit EventArgs

type GiveFeedbackEventArgs = class
    inherit EventArgs

Public Class GiveFeedbackEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

GiveFeedbackEventArgs

Attribute

ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird ein Drag-and-Drop-Vorgang zwischen zwei ListBox Steuerelementen veranschaulicht. Im Beispiel wird die Methode aufgerufen, wenn die DoDragDrop Ziehenaktion gestartet wird. Die Ziehen-Aktion beginnt, wenn die Maus während des MouseDown Ereignisses mehr SystemInformation.DragSize als vom Mausspeicherort verschoben wurde. Die IndexFromPoint Methode wird verwendet, um den Index des Elements zu bestimmen, der während des MouseDown Ereignisses gezogen werden soll.

Im Beispiel wird auch die Verwendung benutzerdefinierter Cursor für den Drag-and-Drop-Vorgang veranschaulicht. Im Beispiel wird davon ausgegangen, dass zwei Cursordateien 3dwarro.cur und 3dwno.curim Anwendungsverzeichnis vorhanden sind, für die benutzerdefinierten Drag- und No-Drop-Cursor bzw. keine Drop-Cursor. Die benutzerdefinierten Cursor werden verwendet, wenn dies UseCustomCursorsCheck CheckBox überprüft wird. Die benutzerdefinierten Cursor werden im GiveFeedback Ereignishandler festgelegt.

Der Tastaturzustand wird im Ereignishandler für das DragOver richtige ListBoxEreignis ausgewertet, um zu bestimmen, welche Ziehenoperation auf dem Zustand der UMSCHALT-, STRG-, ALT- oder STRG+ALT-Tasten basiert. Die Position in der Stelle, an der ListBox das Drop auftreten würde, wird auch während des DragOver Ereignisses bestimmt. Wenn die zu ablegenden Daten kein StringWert sind, wird der DragEventArgs.Effect Wert auf DragDropEffects.None". Schließlich wird der Status des Drops im DropLocationLabel LabelBereich angezeigt.

Die Daten, die für das Recht ListBox fallen, werden im DragDrop Ereignishandler bestimmt und der String Wert wird an der entsprechenden Stelle im ListBoxEreignishandler hinzugefügt. Wenn der Ziehenvorgang außerhalb der Grenzen des Formulars verschoben wird, wird der Drag-and-Drop-Vorgang im QueryContinueDrag Ereignishandler abgebrochen.

Dieser Codeauszug veranschaulicht die Verwendung der GiveFeedbackEventArgs Klasse. Siehe die Methode für das DoDragDrop vollständige Codebeispiel.

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

Hinweise

Das GiveFeedback Ereignis tritt während eines Ziehensvorgangs auf. Es ermöglicht der Quelle eines Drag-Ereignisses, die Darstellung des Mauszeigers zu ändern, um dem Benutzer visuelles Feedback während eines Drag-and-Drop-Vorgangs zu geben. Ein GiveFeedbackEventArgs Objekt gibt den Typ des Drag-and-Drop-Vorgangs an und ob Standardcursor verwendet werden.

Informationen zum Ereignismodell finden Sie unter Behandeln und Auslösen von Ereignissen.

Konstruktoren

GiveFeedbackEventArgs(DragDropEffects, Boolean)

Initialisiert eine neue Instanz der GiveFeedbackEventArgs-Klasse.

Eigenschaften

Effect	Ruft das angezeigte Feedback der Drag & Drop-Operation ab.
UseDefaultCursors	Ruft ab, ob für einen Ziehvorgang die Standardcursor verwendet werden sollen, die Drag & Drop-Effekten zugeordnet sind.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)