SelectionDrag イベント

ユーザーが選択したオブジェクト上でマウスの左ボタンを短時間押し続けたときに発生します。

シンタックス

Visual Basic

'宣言
 
Public Event SelectionDrag As CancelEventHandler

C#

public event CancelEventHandler SelectionDrag

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelEventArgs 型の引数を受け取りました。次の CancelEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel

解説

新しい選択 (行、列、セルなど) の作成およびドラッグアンドドロップ操作の開始は同じ動作でトリガーできるので (ユーザーはマウス ボタンを押して、マウス ポインタを移動) 、このイベントは 2 つを区別する役割を果たします。

このイベントは、実際にマウス ポインタを移動する前に、ユーザーが選択したオブジェクト上でマウスを短時間押したときに発生します。マウス ポインタが時間が切れる前に移動されなければ、このイベントが生成されます。そうでなければ、新しい選択が作成され、このイベントは生成されません。

cancel 引数は選択プロセスのリストアをプログラムでき、選択アクションをユーザーは続行できます。

プログラマはドラッグアンドドロップ操作を実装するためにこのイベントを使用します。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub UltraGrid1_SelectionDrag(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles ultraGrid1.SelectionDrag

       If Me.ultraGrid1.Selected.Rows.Count > 0 Then
           Debug.WriteLine(Me.ultraGrid1.Selected.Rows.Count & " rows are being dragged.")
       ElseIf Me.ultraGrid1.Selected.Cells.Count > 0 Then
           Debug.WriteLine(Me.ultraGrid1.Selected.Cells.Count & " cells are being dragged.")
       ElseIf Me.ultraGrid1.Selected.Columns.Count > 0 Then
           Debug.WriteLine(Me.ultraGrid1.Selected.Columns.Count & " columns are being dragged.")
       End If

       ' You can cancel the drag by canceling the event.
       e.Cancel = True

   End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void ultraGrid1_SelectionDrag(object sender, System.ComponentModel.CancelEventArgs e)
{		

	if ( this.ultraGrid1.Selected.Rows.Count > 0 )
	{
		Debug.WriteLine( this.ultraGrid1.Selected.Rows.Count + " rows are being dragged." );
	}
	else if ( this.ultraGrid1.Selected.Cells.Count > 0 )
	{
		Debug.WriteLine( this.ultraGrid1.Selected.Cells.Count + " cells are being dragged." );
	}
	else if ( this.ultraGrid1.Selected.Columns.Count > 0 )
	{
		Debug.WriteLine( this.ultraGrid1.Selected.Columns.Count + " columns are being dragged." );
	}

	// You can cancel the drag by canceling the event.
	e.Cancel = true;

}