DragAction 列挙体とは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

DragAction 列挙体

ドラッグアンドドロップ操作を継続するかどうか、および継続する場合はどのように継続するかを指定します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Enumeration DragAction

Visual Basic (使用法)

Dim instance As DragAction

[ComVisibleAttribute(true)] 
public enum DragAction

C++

[ComVisibleAttribute(true)] 
public enum class DragAction

/** @attribute ComVisibleAttribute(true) */ 
public enum DragAction

JScript

ComVisibleAttribute(true) 
public enum DragAction

メンバ

	メンバ名	説明
	Cancel	操作はドロップメッセージなしでキャンセルされます。
	Continue	操作を継続します。
	Drop	ドロップを伴って操作が停止されます。

解説

この列挙体は、QueryContinueDragEventArgs で使用されます。

使用例

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 イベントハンドラでキャンセルされます。

DragAction 列挙体の使い方を次のコード例に示します。コード例全体については、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