GiveFeedbackEventArgs クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ドラッグ操作中に発生する GiveFeedback イベントのデータを提供します。

public ref class GiveFeedbackEventArgs : EventArgs

public class GiveFeedbackEventArgs : EventArgs

type GiveFeedbackEventArgs = class
    inherit EventArgs

Public Class GiveFeedbackEventArgs
Inherits EventArgs

継承

Object

EventArgs

GiveFeedbackEventArgs

例

次の例では、2 つの ListBox コントロール間のドラッグ アンド ドロップ操作を示します。 この例では、ドラッグ アクションの開始時に DoDragDrop メソッドを呼び出します。 ドラッグ 操作は、MouseDown イベント中にマウスの位置からマウスが SystemInformation.DragSize 以上移動した場合に開始されます。 IndexFromPoint メソッドは、MouseDown イベント中にドラッグする項目のインデックスを決定するために使用されます。

この例では、ドラッグ アンド ドロップ操作にカスタム カーソルを使用する方法も示します。 この例では、カスタム ドラッグ カーソルとドロップなしカーソルの 2 つのカーソル ファイル (3dwarro.cur と 3dwno.cur) がアプリケーション ディレクトリに存在することを前提としています。 UseCustomCursorsCheck CheckBox がチェックされている場合は、カスタム カーソルが使用されます。 カスタム カーソルは、GiveFeedback イベント ハンドラーで設定されます。

キーボードの状態は、右 ListBoxの DragOver イベント ハンドラーで評価され、Shift キー、Ctrl キー、Alt キー、または Ctrl + Alt キーの状態に基づいてドラッグ操作を決定します。 ドロップが発生する ListBox 内の場所も、DragOver イベント中に決定されます。 削除するデータが Stringでない場合、DragEventArgs.Effect は DragDropEffects.Noneに設定されます。 最後に、ドロップの状態が DropLocationLabelLabelに表示されます。

適切な ListBox に対して削除するデータは、DragDrop イベント ハンドラーで決定され、String 値は ListBoxの適切な場所に追加されます。 ドラッグ操作がフォームの境界外に移動すると、QueryContinueDrag イベント ハンドラーでドラッグ アンド ドロップ操作が取り消されます。

このコードの抜粋では、GiveFeedbackEventArgs クラスの使用方法を示します。 完全なコード例については、DoDragDrop メソッドを参照してください。

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

注釈

GiveFeedback イベントは、ドラッグ操作中に発生します。 ドラッグ アンド ドロップ操作中にユーザーに視覚的なフィードバックを提供するために、ドラッグ イベントのソースでマウス ポインターの外観を変更できます。 GiveFeedbackEventArgs オブジェクトは、ドラッグ アンド ドロップ操作の種類と、既定のカーソルを使用するかどうかを指定します。

イベント モデルの詳細については、「イベントの処理と発生 を参照してください。

コンストラクター

GiveFeedbackEventArgs(DragDropEffects, Boolean, Bitmap, Point, Boolean)	GiveFeedbackEventArgs クラスの新しいインスタンスを初期化します。
GiveFeedbackEventArgs(DragDropEffects, Boolean)	GiveFeedbackEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

CursorOffset	ドラッグ イメージカーソルのオフセットを取得または設定します。
DragImage	ドラッグイメージビットマップを取得または設定します。
Effect	表示されるドラッグ アンド ドロップ操作のフィードバックを取得します。
UseDefaultCursors	ドラッグ アンド ドロップ効果に関連付けられている既定のカーソルをドラッグ操作で使用するかどうかを取得または設定します。
UseDefaultDragImage	レイヤード ウィンドウドラッグイメージを使用するかどうかを示す値を取得または設定します。

メソッド

Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)