QueryContinueDragEventArgs クラス

[アーティクル]
03/28/2008

QueryContinueDrag イベントのデータを提供します。

この型のすべてのメンバの一覧については、QueryContinueDragEventArgs メンバを参照してください。

System.Object
System.EventArgs
System.Windows.Forms.QueryContinueDragEventArgs

<ComVisible(True)>
Public Class QueryContinueDragEventArgs   Inherits EventArgs
[C#]
[ComVisible(true)]
public class QueryContinueDragEventArgs : EventArgs
[C++]
[ComVisible(true)]
public __gc class QueryContinueDragEventArgs : public EventArgs
[JScript]
public
   ComVisible(true)
class QueryContinueDragEventArgs extends EventArgs

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

QueryContinueDrag イベントは、ドラッグアンドドロップ操作中に発生し、ドラッグソースがドラッグアンドドロップ操作をキャンセルする必要があるかどうかを決定できるようにします。 QueryContinueDragEventArgs は、ドラッグアンドドロップ操作を続行するかどうか、続行する場合はその方法、修飾子キーが押されたかどうか、ユーザーが Esc キーを押したかどうかを指定します。

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

イベントモデルの詳細については、「イベントとデリゲート」を参照してください。

使用例

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

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

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

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

[Visual Basic, C#, C++] System.Windows.Forms.Control.QueryContinueDragEvent イベントで QueryContinueDragEventArgs クラスを使用する例を次に示します。コード例全体については、 DoDragDrop メソッドのトピックを参照してください。

 
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

[C#] 
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++] 
private:
   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 != 0) {

            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;
            }
         }
      }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

QueryContinueDragEventArgs メンバ | System.Windows.Forms 名前空間 | DragAction | DoDragDrop

次の方法で共有

QueryContinueDragEventArgs クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース