GiveFeedbackEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

GiveFeedbackEventArgs.cs

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

public class GiveFeedbackEventArgs : EventArgs

Vererbung

Object

EventArgs

GiveFeedbackEventArgs

Beispiele

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

Das Beispiel veranschaulicht auch die Verwendung von benutzerdefinierten Cursorn für den Drag-and-Drop-Vorgang. Im Beispiel wird davon ausgegangen, dass zwei Cursordateien, 3dwarro.cur und 3dwno.cur, im Anwendungsverzeichnis vorhanden sind, für die benutzerdefinierten Mauszeiger bzw. Cursor ohne Drop. Die benutzerdefinierten Cursor werden verwendet, wenn die UseCustomCursorsCheckCheckBox aktiviert ist. Die benutzerdefinierten Cursor werden im GiveFeedback Ereignishandler festgelegt.

Der Tastaturzustand wird im DragOver Ereignishandler für die richtige ListBoxausgewertet, um zu bestimmen, welche Ziehoperation auf dem Zustand der UMSCHALTTASTE, STRG, ALT oder STRG+ALT basiert. Die Position in der ListBox, an der der Abbruch erfolgen würde, wird auch während des DragOver-Ereignisses bestimmt. Wenn die zu löschenden Daten keine Stringsind, wird die DragEventArgs.Effect auf DragDropEffects.Nonefestgelegt. Schließlich wird der Status des Drops im DropLocationLabelLabelangezeigt.

Die für den richtigen ListBox zu löschenden Daten werden im DragDrop-Ereignishandler bestimmt, und der String Wert wird an der entsprechenden Stelle im ListBoxhinzugefügt. Wenn der Ziehvorgang 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. Die DoDragDrop-Methode finden Sie im vollständigen Codebeispiel.

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

Hinweise

Das GiveFeedback-Ereignis tritt während eines Ziehvorgangs 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 gibt an, ob Standardcursor verwendet werden.

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

Konstruktoren

GiveFeedbackEventArgs(DragDropEffects, Boolean, Bitmap, Point, Boolean)	Initialisiert eine neue Instanz der GiveFeedbackEventArgs Klasse.
GiveFeedbackEventArgs(DragDropEffects, Boolean)	Initialisiert eine neue Instanz der GiveFeedbackEventArgs Klasse.

Eigenschaften

CursorOffset	Ruft den Offset des Ziehen-Bildcursors ab oder legt ihn fest.
DragImage	Ruft die Bitmap für das Ziehen von Bildern ab oder legt sie fest.
Effect	Ruft das Feedback des Drag-and-Drop-Vorgangs ab, das angezeigt wird.
UseDefaultCursors	Ruft ab oder legt fest, ob der Ziehvorgang die Standardcursor verwenden soll, die mit Drag-Drop-Effekten verknüpft sind.
UseDefaultDragImage	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Bild für das Ziehen von ebenen Fenstern verwendet wird.

Gilt für: