Control.GiveFeedback Olay

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Sürükleme işlemi sırasında gerçekleşir.

public:
 event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;

public event System.Windows.Forms.GiveFeedbackEventHandler? GiveFeedback;

member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler 

Public Custom Event GiveFeedback As GiveFeedbackEventHandler 

Olay Türü

GiveFeedbackEventHandler

Örnekler

Aşağıdaki kod örneği, iki ListBox denetimi arasındaki sürükle ve bırak işlemini gösterir. Örnek, sürükleme eylemi başladığında DoDragDrop yöntemini çağırır. Sürükleme eylemi, MouseDown olayı sırasında farenin fare konumundan SystemInformation.DragSize fazla hareket ettiyse başlar. IndexFromPoint yöntemi, MouseDown olayı sırasında sürüklenecek öğenin dizinini belirlemek için kullanılır.

Örnekte, sürükle ve bırak işlemi için özel imleçlerin kullanılması da gösterilmektedir. Örnek, özel sürükleme ve bırakmama imleçleri için uygulama dizininde sırasıyla 3dwarro.cur ve 3dwno.curiki imleç dosyasının var olmasını gerektirir. UseCustomCursorsCheck CheckBox işaretliyse özel imleçler kullanılır. Özel imleçler GiveFeedback olay işleyicisinde ayarlanır.

Klavye durumu, shift, CTRL, ALT veya CTRL+ALT tuşlarının durumuna bağlı olarak sürükleme işleminin ne olacağını belirlemek üzere doğru ListBoxiçin DragOver olay işleyicisinde değerlendirilir. ListBox bırakmanın gerçekleşeceği konum da DragOver olayı sırasında belirlenir. Bırakacak veriler bir Stringdeğilse, DragEventArgs.EffectDragDropEffectsiçinde None olarak ayarlanır. Son olarak, bırakmanın durumu DropLocationLabelLabelgörüntülenir.

Doğru ListBox bırakacak veriler DragDrop olay işleyicisinde belirlenir ve String değeri ListBoxuygun yere eklenir. Sürükleme işlemi formun sınırlarının dışına taşınırsa, QueryContinueDrag olay işleyicisinde sürükle ve bırak işlemi iptal edilir.

Bu kod alıntısı GiveFeedback olayının kullanılmasını gösterir. Kod örneğinin tamamı için DoDragDrop yöntemine bakın.

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

Açıklamalar

GiveFeedback olayı, sürükle ve bırak işlemi başlatıldığında oluşturulur. GiveFeedback olayıyla, sürükleme olayının kaynağı, sürükle ve bırak işlemi sırasında kullanıcıya görsel geri bildirim sağlamak için fare işaretçisinin görünümünü değiştirebilir.

Aşağıda, sürükle ve bırak işlemleriyle ilgili olayların nasıl ve ne zaman tetiklediği açıklanmaktadır.

DoDragDrop yöntemi, geçerli imleç konumu altındaki denetimi belirler. Ardından denetimin geçerli bir bırakma hedefi olup olmadığını denetler.

Denetim geçerli bir bırakma hedefiyse, GiveFeedback olayı sürükle ve bırak efekti belirtilen şekilde oluşturulur. Sürükle ve bırak efektlerinin listesi için DragDropEffects numaralandırmasına bakın.

Fare imleci konumu, klavye durumu ve fare düğmesi durumundaki değişiklikler izlenir.

• Kullanıcı bir pencereden dışarı taşınırsa, DragLeave olayı oluşturulur.

• Fare başka bir denetime girerse, bu denetimin DragEnter oluşturulur.

• Fare hareket eder ancak aynı denetim içinde kalırsa, DragOver olayı oluşturulur.

Klavye veya fare düğmesi durumunda bir değişiklik varsa, QueryContinueDrag olayı oluşturulur ve sürüklemeye devam etmek, verileri bırakmak veya olayın QueryContinueDragEventArgsAction özelliğinin değerine göre işlemi iptal etmek için belirlenir.

• DragAction değeri Continueise, işleme devam etmek için DragOver olayı oluşturulur ve uygun görsel geri bildirimin ayarlanabilmesi için GiveFeedback olayı yeni etkiyle oluşturulur. Geçerli bırakma efektlerinin listesi için DragDropEffects numaralandırmasına bakın.

  Not

  DragOver ve GiveFeedback olayları eşleştirilir, böylece fare bırakma hedefi boyunca hareket ettikçe kullanıcıya farenin konumuyla ilgili en up-totarih geri bildirimi verilir.

• DragAction değeri Dropise, kaynak uygulamanın kaynak verilerde uygun işlemi gerçekleştirebilmesi için bırakma efekti değeri kaynağa döndürülür; örneğin, işlem bir taşıma işlemiyse verileri kesin.

• DragAction değeri Cancelise, DragLeave olayı oluşturulur.

Olayları işleme hakkında daha fazla bilgi için bkz. olayları işleme ve oluşturma.

Ayrıca bkz.

• OnGiveFeedback(GiveFeedbackEventArgs)