GiveFeedbackEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dostarcza dane dla zdarzenia GiveFeedback, które występuje podczas operacji przeciągania.

public ref class GiveFeedbackEventArgs : EventArgs

public class GiveFeedbackEventArgs : EventArgs

type GiveFeedbackEventArgs = class
    inherit EventArgs

Public Class GiveFeedbackEventArgs
Inherits EventArgs

Dziedziczenie

Object

EventArgs

GiveFeedbackEventArgs

Przykłady

W poniższym przykładzie pokazano operację przeciągania i upuszczania między dwoma kontrolkami ListBox. Przykład wywołuje metodę DoDragDrop po uruchomieniu akcji przeciągania. Akcja przeciągania rozpoczyna się, jeśli mysz przeniosła się więcej niż SystemInformation.DragSize z lokalizacji myszy podczas zdarzenia MouseDown. Metoda IndexFromPoint służy do określania indeksu elementu do przeciągania podczas zdarzenia MouseDown.

W przykładzie pokazano również użycie niestandardowych kursorów dla operacji przeciągania i upuszczania. W przykładzie przyjęto założenie, że dwa pliki kursorów, 3dwarro.cur i 3dwno.cur, istnieją w katalogu aplikacji, odpowiednio dla niestandardowego przeciągania i bez upuszczania kursorów. Kursory niestandardowe będą używane, jeśli zaznaczono UseCustomCursorsCheckCheckBox. Kursory niestandardowe są ustawiane w procedurze obsługi zdarzeń GiveFeedback.

Stan klawiatury jest obliczany w procedurze obsługi zdarzeń DragOver dla prawego ListBox, aby określić, jaka operacja przeciągania będzie oparta na stanie SHIFT, CTRL, ALT lub CTRL+ALT. Lokalizacja w ListBox, w której występuje spadek, jest również określana podczas zdarzenia DragOver. Jeśli dane do porzucenia nie są String, DragEventArgs.Effect jest ustawiona na wartość DragDropEffects.None. Na koniec stan upuszczania jest wyświetlany w DropLocationLabelLabel.

Dane do upuszczania odpowiedniego ListBox są określane w procedurze obsługi zdarzeń DragDrop, a wartość String jest dodawana w odpowiednim miejscu w ListBox. Jeśli operacja przeciągania przesuwa się poza granice formularza, operacja przeciągania i upuszczania zostanie anulowana w programie obsługi zdarzeń QueryContinueDrag.

Ten fragment kodu przedstawia użycie klasy GiveFeedbackEventArgs. Zobacz metodę DoDragDrop, aby zapoznać się z kompletnym przykładem kodu.

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

Uwagi

Zdarzenie GiveFeedback występuje podczas operacji przeciągania. Umożliwia źródło zdarzenia przeciągania w celu zmodyfikowania wyglądu wskaźnika myszy, aby przekazać użytkownikowi opinię podczas operacji przeciągania i upuszczania. Obiekt GiveFeedbackEventArgs określa typ operacji przeciągania i upuszczania oraz określa, czy są używane domyślne kursory.

Aby uzyskać informacje o modelu zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Konstruktory

GiveFeedbackEventArgs(DragDropEffects, Boolean, Bitmap, Point, Boolean)	Inicjuje nowe wystąpienie klasy GiveFeedbackEventArgs.
GiveFeedbackEventArgs(DragDropEffects, Boolean)	Inicjuje nowe wystąpienie klasy GiveFeedbackEventArgs.

Właściwości

CursorOffset	Pobiera lub ustawia przesunięcie kursora obrazu przeciągania.
DragImage	Pobiera lub ustawia mapę bitową obrazu przeciągania.
Effect	Pobiera wyświetlane informacje zwrotne dotyczące operacji przeciągania i upuszczania.
UseDefaultCursors	Pobiera lub ustawia, czy operacja przeciągania powinna używać domyślnych kursorów skojarzonych z efektami przeciągania i upuszczania.
UseDefaultDragImage	Pobiera lub ustawia wartość wskazującą, czy jest używany obraz przeciągania okna warstwowego.

Metody

Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)