Control.QueryContinueDrag イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.QueryContinueDrag イベント

ドラッグアンドドロップ操作中に発生し、ドラッグソースがドラッグアンドドロップ操作をキャンセルする必要があるかどうかを決定できるようにします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event QueryContinueDrag As
 QueryContinueDragEventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As QueryContinueDragEventHandler

AddHandler instance.QueryContinueDrag, handler

public event QueryContinueDragEventHandler QueryContinueDrag

C++

public:
event QueryContinueDragEventHandler^ QueryContinueDrag {
    void add (QueryContinueDragEventHandler^ value);
    void remove (QueryContinueDragEventHandler^ value);
}

/** @event */
public void add_QueryContinueDrag (QueryContinueDragEventHandler
 value)

/** @event */
public void remove_QueryContinueDrag (QueryContinueDragEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

QueryContinueDrag イベントは、ドラッグアンドドロップ操作中、キーボードまたはマウスボタンの状態に変更があったときに発生します。QueryContinueDrag イベントにより、ドラッグソースはドラッグアンドドロップ操作をキャンセルする必要があるかどうかを判断できます。

DoDragDrop メソッドは、現在のカーソル位置に従ってコントロールを判別します。次に、コントロールが有効なドロップターゲットかどうかを確認します。

コントロールが有効なドロップターゲットの場合、指定したドラッグアンドドロップの効果が付いた状態で GiveFeedback イベントが発生します。ドラッグアンドドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

マウスカーソルの位置、キーボードの状態、およびマウスボタンの状態の変更が監視されます。

ユーザーがウィンドウの外に移動した場合、DragLeave イベントが生成されます。
マウスが別のコントロールに移動した場合は、そのコントロールの DragEnter が生成されます。
マウスが移動しても同じコントロール内の場合は、DragOver イベントが生成されます。

キーボードまたはマウスボタンの状態に変更があった場合、QueryContinueDrag イベントが生成され、このイベントの QueryContinueDragEventArgs の Action プロパティの値に応じて、ドラッグを継続するか、データをドロップするか、操作をキャンセルするかが判断されます。

DragAction の値が Continue の場合、操作を継続するための DragOver イベントが生成され、適切な視覚的フィードバックを設定できるように新しい効果による GiveFeedback イベントが生成されます。有効なドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

メモ
DragOver イベントおよび GiveFeedback イベントはペアになっています。したがって、マウスがドロップターゲットをまたがって移動した場合、マウスの位置に関する最新のフィードバックがユーザーに提示されます。

DragAction の値が Drop の場合、ドロップ効果の値がソースに返されます。ソースアプリケーションでは、ソースデータに対して適切な操作を実行できます。たとえば、移動操作だった場合は、データの切り取りなどを実行できます。
DragAction の値が Cancel の場合、DragLeave イベントが生成されます。

既定では、Esc キーが押された場合、QueryContinueDrag イベントは DragAction で Action を Cancel に設定します。また、マウスの左ボタン、中央ボタン、または右ボタンが押された場合は、DragAction で Action を Drop に設定します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

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

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

キーボードの状態は、右側の ListBox の DragOver イベントハンドラで評価されます。ドラッグ操作の内容は、Shift キー、Ctrl キー、Alt キー、または Ctrl + Alt キーの状態によって決まります。ドロップが発生する ListBox 内の位置は、DragOver イベント時にも判定されます。ドロップするデータが String でない場合は、DragEventArgs.Effect が DragDropEffects で None に設定されます。最後に、ドロップのステータスが DropLocationLabelLabel に表示されます。

右側の ListBox にドロップするデータは、DragDrop イベントハンドラで判定されます。また、String 値が ListBox の該当する場所に追加されます。ドラッグ操作がフォームの範囲を超えて移動した場合、ドラッグアンドドロップ操作は QueryContinueDrag イベントハンドラでキャンセルされます。

QueryContinueDrag イベントの使用方法を次のコード例に示します。コード例全体については、DoDragDrop メソッドのトピックを参照してください。

Visual Basic

Private Sub ListDragSource_QueryContinueDrag(ByVal
 sender As Object, ByVal
 e As QueryContinueDragEventArgs) Handles ListDragSource.QueryContinueDrag
    ' Cancel the drag if the mouse moves off the form.
    Dim lb as ListBox = CType(sender, System.Windows.Forms.ListBox)

    If Not (lb is nothing)
 Then

        Dim f as Form = lb.FindForm()

        ' Cancel the drag if the mouse moves off the form. The screenOffset
        ' takes into account any desktop bands that may be at the top
 or left
        ' side of the screen.
        If (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left)
 Or _
            ((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right)
 Or _
            ((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top)
 Or _
            ((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom))
 Then

            e.Action = DragAction.Cancel
        End If
    End if
End Sub

private void ListDragSource_QueryContinueDrag(object
 sender, System.Windows.Forms.QueryContinueDragEventArgs e) {
    // Cancel the drag if the mouse moves off the form.
    ListBox lb = sender as ListBox;

    if (lb != null) {

        Form f = lb.FindForm();

        // Cancel the drag if the mouse moves off the form. The screenOffset
        // takes into account any desktop bands that may be at the top
 or left
        // side of the screen.
        if (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left)
 ||
            ((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right)
 ||
            ((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top)
 ||
            ((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom))
 {

            e.Action = DragAction.Cancel;
        }
    }
}

C++

void ListDragSource_QueryContinueDrag( Object^ sender, System::Windows::Forms::QueryContinueDragEventArgs^
 e )
{
   // Cancel the drag if the mouse moves off the form.
   ListBox^ lb = dynamic_cast<ListBox^>(sender);
   if ( lb != nullptr )
   {
      Form^ f = lb->FindForm();

      // Cancel the drag if the mouse moves off the form. The screenOffset
      // takes into account any desktop bands that may be at the top
 or left
      // side of the screen.
      if ( ((Control::MousePosition.X - screenOffset.X) < f->DesktopBounds.Left)
 || ((Control::MousePosition.X - screenOffset.X) > f->DesktopBounds.Right)
 || ((Control::MousePosition.Y - screenOffset.Y) < f->DesktopBounds.Top) || ((Control::MousePosition.Y - screenOffset.Y) > f->DesktopBounds.Bottom) )
      {
         e->Action = DragAction::Cancel;
      }
   }
}

private void listDragSource_QueryContinueDrag(Object
 sender, 
    System.Windows.Forms.QueryContinueDragEventArgs e)
{
    // Cancel the drag if the mouse moves off the form.
    ListBox lb = (ListBox)sender;

    if (lb != null) {
        Form f = lb.FindForm();
        // Cancel the drag if the mouse moves off the form. The 
        // screenOffset takes into account any desktop bands 
        // that may be at the top or left side of the screen.
        if (Control.get_MousePosition().get_X() - screenOffset.get_X()
 
            < f.get_DesktopBounds().get_Left() 
            || Control.get_MousePosition().get_X() 
            - screenOffset.get_X() > f.get_DesktopBounds().get_Right() 
            || Control.get_MousePosition().get_Y() - screenOffset.get_Y() 
            < f.get_DesktopBounds().get_Top() 
            || Control.get_MousePosition().get_Y() - screenOffset.get_Y() 
            > f.get_DesktopBounds().get_Bottom()) {
            e.set_Action(DragAction.Cancel);
        }
    }
} //listDragSource_QueryContinueDrag