GiveFeedbackEventArgs Klasse

Definition

Stellt Daten für das GiveFeedback-Ereignis bereit, das während eines Ziehvorgangs eintritt.Provides data for the GiveFeedback event, which occurs during a drag operation.

public ref class GiveFeedbackEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class GiveFeedbackEventArgs : EventArgs
type GiveFeedbackEventArgs = class
    inherit EventArgs
Public Class GiveFeedbackEventArgs
Inherits EventArgs
Vererbung
GiveFeedbackEventArgs
Attribute

Beispiele

Im folgenden Beispiel wird ein Drag & Drop-Vorgang zwischen zwei ListBox-Steuerelementen veranschaulicht.The following example demonstrates a drag-and-drop operation between two ListBox controls. Im Beispiel wird die DoDragDrop-Methode aufgerufen, wenn die Zieh Aktion gestartet wird.The example calls the DoDragDrop method when the drag action starts. Die Zieh Aktion wird gestartet, wenn die Maus während des MouseDown Ereignisses mehr als SystemInformation.DragSize von der Mausposition bewegt hat.The drag action starts if the mouse has moved more than SystemInformation.DragSize from the mouse location during the MouseDown event. Die IndexFromPoint-Methode wird verwendet, um den Index des Elements zu bestimmen, das während des MouseDown Ereignisses gezogen werden soll.The IndexFromPoint method is used to determine the index of the item to drag during the MouseDown event.

Das Beispiel zeigt auch die Verwendung von benutzerdefinierten Cursorn für den Drag & Drop-Vorgang.The example also demonstrates using custom cursors for the drag-and-drop operation. Im Beispiel wird davon ausgegangen, dass zwei Cursor Dateien (3dwarro.cur und 3dwno.curim Anwendungsverzeichnis vorhanden sind, für die benutzerdefinierten Drag-und No-Drop-Cursor.The example assumes that two cursor files, 3dwarro.cur and 3dwno.cur, exist in the application directory, for the custom drag and no-drop cursors, respectively. Die benutzerdefinierten Cursor werden verwendet, wenn die UseCustomCursorsCheckCheckBox aktiviert ist.The custom cursors will be used if the UseCustomCursorsCheckCheckBox is checked. Die benutzerdefinierten Cursor werden im GiveFeedback Ereignishandler festgelegt.The custom cursors are set in the GiveFeedback event handler.

Der Tastatur Zustand wird im DragOver Ereignishandler für die Rechte ListBoxausgewertet, um zu bestimmen, welcher Zieh Vorgang auf dem Zustand der UMSCHALTTASTE, STRG, alt oder STRG + ALT-Taste basiert.The keyboard state is evaluated in the DragOver event handler for the right ListBox, to determine what the drag operation will be based upon state of the SHIFT, CTRL, ALT, or CTRL+ALT keys. Der Speicherort in der ListBox, wo der Ablage auftritt, wird auch während des DragOver Ereignisses festgelegt.The location in the ListBox where the drop would occur is also determined during the DragOver event. Wenn es sich bei den zu Lösch Endes Daten nicht um einen Stringhandelt, wird der DragEventArgs.Effect auf DragDropEffects.Nonefestgelegt.If the data to drop is not a String, then the DragEventArgs.Effect is set to DragDropEffects.None. Schließlich wird der Status der Ablage in der DropLocationLabelLabelangezeigt.Finally, the status of the drop is displayed in the DropLocationLabelLabel.

Die Daten, die für die Rechte ListBox gelöscht werden, werden im DragDrop-Ereignishandler bestimmt, und der String Wert wird an der entsprechenden Stelle in der ListBoxhinzugefügt.The data to drop for the right ListBox is determined in the DragDrop event handler and the String value is added at the appropriate place in the ListBox. Wenn der Zieh Vorgang außerhalb der Begrenzungen des Formulars verschoben wird, wird der Drag & Drop-Vorgang im Ereignishandler QueryContinueDrag abgebrochen.If the drag operation moves outside the bounds of the form, then the drag-and-drop operation is canceled in the QueryContinueDrag event handler.

Dieser Code Ausschnitt veranschaulicht die Verwendung der GiveFeedbackEventArgs-Klasse.This code excerpt demonstrates using the GiveFeedbackEventArgs class. Das gesamte Codebeispiel finden Sie in der DoDragDrop-Methode.See the DoDragDrop method for the complete code example.

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, 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 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 Zieh Vorgangs auf.The GiveFeedback event occurs during a drag operation. Dies ermöglicht es der Quelle eines Drag-Ereignisses, die Darstellung des Mauszeigers zu ändern, um dem Benutzer visuelles Feedback während eines Drag & Drop-Vorgangs zu geben.It allows the source of a drag event to modify the appearance of the mouse pointer in order to give the user visual feedback during a drag-and-drop operation. Ein GiveFeedbackEventArgs-Objekt gibt den Typ des Drag & Drop-Vorgangs an und gibt an, ob standardcursorn verwendet werden.A GiveFeedbackEventArgs object specifies the type of drag-and-drop operation and whether default cursors are used.

Weitere Informationen zum Ereignis Modell finden Sie unter behandeln und Auswerfen von Ereignissen.For information about the event model, see Handling and Raising Events.

Konstruktoren

GiveFeedbackEventArgs(DragDropEffects, Boolean)

Initialisiert eine neue Instanz der GiveFeedbackEventArgs-Klasse.Initializes a new instance of the GiveFeedbackEventArgs class.

Eigenschaften

Effect

Ruft das angezeigte Feedback der Drag & Drop-Operation ab.Gets the drag-and-drop operation feedback that is displayed.

UseDefaultCursors

Ruft ab, ob für einen Ziehvorgang die Standardcursor verwendet werden sollen, die Drag & Drop-Effekten zugeordnet sind.Gets or sets whether drag operation should use the default cursors that are associated with drag-drop effects.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: