Items のドラッグアンドドロップのコントロール

WinExplorerBar エレメントは、グループ間での項目のドラッグアンドドロップを自動的にサポートします。どの項目をドラッグでき、それをどこにドロップできるかを細かく制御するためのプロパティがあります。また、ドラッグアンドドロッププロセスを管理するためのイベントもあります。

コードの記述を開始する前にコードビハインドに使用/インポートのディレクティブを配置します。そうすれば、メンバは完全に記述された名前を常に入力する必要がなくなります。

Visual Basic の場合：

Imports Infragistics.Win.UltraWinExplorerBar

C# の場合：

using Infragistics.Win.UltraWinExplorerBar;

項目のItemSettings オブジェクトの AllowDragCopy および AllowDragMove プロパティを使用して、ドラッグアンドドロップを使用して項目を移動またはコピーできるかどうかを指定します。これらのプロパティの列挙型の設定を使用して、項目を含むグループを基準としてドラッグアンドドロップによる移動の範囲を指定します。使用可能な設定は、None、Within Groups、および Within And Across Groups です。また、デフォルト設定を使用することで、これらのプロパティを継承することもできます。

これらのプロパティを両方とも None に設定すると、項目をドラッグアンドドロップできなくなります。両方のプロパティを None 以外の値に設定すると、標準的なドラッグアンドドロップのキーボード規則（ドラッグまたはドラッグ+ Shift キーで移動、ドラッグ+ Ctrl キーでコピー）を使用して項目を移動またはコピーできます。各プロパティを個別に設定すると、指定した範囲内で対応する動作（項目の移動のみまたはコピーのみ）を実行できます。

次のコードは、指定した項目をそのグループ内でのみ移動できるようにします。グループの外に移動またはコピーすることはできません。

Visual Basic の場合：

Private Sub SupportingDragandDrop_Load(ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles MyBase.Load
	Me.UltraExplorerBar1.Groups(0).Items("Camper").Settings.AllowDragCopy = ItemDragStyle.None
	Me.UltraExplorerBar1.Groups(0).Items("Camper").Settings.AllowDragMove = ItemDragStyle.WithinGroupOnly
End Sub

C# の場合：

private void SupportingDragandDrop_Load(object sender, System.EventArgs e)
{
	this.ultraExplorerBar1.Groups[0].Items["Camper"].Settings.AllowDragCopy = ItemDragStyle.None;
	this.ultraExplorerBar1.Groups[0].Items["Camper"].Settings.AllowDragMove = ItemDragStyle.WithinGroupOnly;
}

明示的に設定しなければ、AllowDragCopy プロパティおよび AllowDragMove プロパティは、Items のStyle が Label または Separator の場合は False に解決され、それ以外のすべての Item スタイルの場合は True に解決されます。

グループの GroupSettings オブジェクトの AllowItemDrop プロパティは、特定のグループを、他の Groups から Items をドラッグアンドドロップする際のターゲットにできるかどうかを指定します。このプロパティはデフォルト設定可能なブール値です。つまり、値を継承することも、明示的に True または False を設定することもできます。

GroupSettings オブジェクトには AllowDrag プロパティも含まれます。このプロパティは、グループ全体をドラッグできるかどうかを指定します。このプロパティが True に解決される場合、ユーザーはマウスでグループの順序を変更できます。コントロールの Style プロパティが ExplorerBar に設定されていて、その ColumnCount プロパティが 1 より大きい場合は、グループのドラッグはサポート されません 。

項目とグループに権限を設定するだけでなく、エレメントによって提供されるイベントを使用してドラッグアンドドロッププロセスに関与することもできます。UltraWinExplorerBar にはドラッグアンドドロッププロセス中に呼び出されるイベントが 6 つあります。そのうち 3 つは項目に関するもので、残り 3 つはグループに関するものです。これらのイベントの概要を以下に示します。
- GroupDragging - ユーザーがグループをドラッグしようとしたときに発生します。このイベントを使用すれば、グループと、アプリケーションの状態を調べ、ドラッグアンドドロップ操作が許可されているかどうかを判断できます。このイベントの cancel パラメータを True に設定すると、グループがドラッグできなくなります。

Visual Basic の場合：

Private Sub UltraExplorerBar1_GroupDragging(ByVal sender As Object, _
  ByVal e As Infragistics.Win.UltraWinExplorerBar.CancelableGroupEventArgs) _
  Handles UltraExplorerBar1.GroupDragging
	' このコードはグループのヘッダの ForeColor が赤かどうかをチェックし、
	' 赤の場合はグループのドラッグを禁止します。
	If e.Group.Settings.AppearancesLarge.HeaderAppearance.ForeColor.Equals(Color.Red) _
	  Or e.Group.Settings.AppearancesSmall.HeaderAppearance.ForeColor.Equals(Color.Red) _
	  Then
		e.Cancel = True
	End If
End Sub

C# の場合：

private void ultraExplorerBar1_GroupDragging(object sender, Infragistics.Win.UltraWinExplorerBar.CancelableGroupEventArgs e)
{
	// このコードはグループのヘッダの ForeColor が赤かどうかをチェックし、
	// 赤の場合はグループのドラッグを禁止します。
	if (e.Group.Settings.AppearancesLarge.HeaderAppearance.ForeColor.Equals(Color.Red) ||
	  e.Group.Settings.AppearancesSmall.HeaderAppearance.ForeColor.Equals(Color.Red))
	{
		e.Cancel = true;
	}
}

GroupDragOver - ドラッグされるグループが、ドロップ可能なターゲットグループの上に来たときに発生します。このイベントのパラメータには、TargetGroup、TargetGroupRelativePosition、および AllowDrop があります。TargetGroup は、現在のグループのドロップ先の Group オブジェクトを返します。TargetGroupRelativePosition は、ドラッグしたグループをドロップしたときに、ターゲットグループの前と後のどちらに配置されるかを示す列挙値を渡します。AllowDrop は、ドラッグしたグループを現在のターゲットグループにドロップできるかどうかを示します。その他にも、ドラッグ中のグループ、表示されているマウスカーソル、および画面座標内でのグループの X 座標と Y 座標にアクセスするパラメータがあります。

Visual Basic の場合：

Private Sub UltraExplorerBar1_GroupDragOver(ByVal sender As Object, _
  ByVal e As Infragistics.Win.UltraWinExplorerBar.GroupDragOverEventArgs) _
  Handles UltraExplorerBar1.GroupDragOver
	' このコードは、Group 0 よりも上にどのグループもドロップできないようにすることで、
	' 一番上のグループを最上位に保持します。
	' これは、エレメントの ListBar または Toolbox であることを前提とします。
	If e.TargetGroup.Index = 0 Then
		If e.TargetGroupRelativePosition = GroupDropPosition.Before Then
			e.DragCursor = System.Windows.Forms.Cursors.PanSouth
			e.AllowDrop = False
		ElseIf e.TargetGroupRelativePosition = GroupDropPosition.After Then
			e.DragCursor = Cursors.Default
			e.AllowDrop = True
		End If
	End If
End Sub

C# の場合：

private void ultraExplorerBar1_GroupDragOver(object sender, Infragistics.Win.UltraWinExplorerBar.GroupDragOverEventArgs e)
{
	// このコードは、Group 0 よりも上にどのグループもドロップできないようにすることで、
	// 一番上のグループを最上位に保持します。
	// これは、エレメントの ListBar または Toolbox であることを前提とします。
	if (e.TargetGroup.Index == 0)
	{
		if (e.TargetGroupRelativePosition == GroupDropPosition.Before)
		{
			e.DragCursor = System.Windows.Forms.Cursors.PanSouth;
			e.AllowDrop = false;
		}
		else if (e.TargetGroupRelativePosition == GroupDropPosition.After)
		{
			e.DragCursor = System.Windows.Forms.Cursors.Default;
			e.AllowDrop = true;
		}
	}
}

GroupDropped - グループのドラッグアンドドロップ操作が完了し、ドラッグされたグループが Groups コレクションの新しい位置を占めたときに発生します。パラメータには OriginalIndex があります。このパラメータは、ドラッグされたグループのドラッグアンドドロップを行う前の Groups コレクション内での位置を示します。
ItemDragging - ユーザーが項目をドラッグしようとしたときに発生します。このイベントを使用すれば、項目と、アプリケーションの状態を調べ、ドラッグアンドドロップ操作が許可されているかどうかを判断できます。このイベントの cancel パラメータを True に設定すると、項目がドラッグできなくなります。
ItemDragOver - ドラッグ中の項目が、ドロップ可能なターゲットグループの上に来たときに発生します。このイベントのパラメータには、TargetGroup、DragAction、および AllowDrop があります。TargetGroup は、現在の項目のドロップ先の Group オブジェクトを返します。 DragAction は、項目がコピーされるか、または移動されるかを示す列挙値を渡します。AllowDrop は、ドラッグした項目を現在のターゲットグループにドロップできるかどうかを示します。その他にも、ドラッグ中の項目、表示されているマウスカーソル、および画面座標内での項目の X 座標と Y 座標にアクセスするパラメータがあります。

Visual Basic の場合：

Private Sub UltraExplorerBar1_ItemDragOver(ByVal sender As Object, _
  ByVal e As Infragistics.Win.UltraWinExplorerBar.ItemDragOverEventArgs) _
  Handles UltraExplorerBar1.ItemDragOver
	If e.DragAction = Infragistics.Win.UltraWinExplorerBar.ItemDragAction.Copy Then
		' 項目を Group1 にコピーすることのみを許可します。
		If e.TargetGroup.Key = "Group1" Then
			Me.StatusBar1.Text = "Drop item here to copy it."
			e.DragCursor = System.Windows.Forms.Cursors.Default
			e.AllowDrop = True
		Else
			' ステータス バーのテキストとカーソルを更新し、
			' 項目をコピーできないことを示します。
			Me.StatusBar1.Text = "Item cannot be dropped on Group '" + e.TargetGroup.Text + "'."
			e.DragCursor = System.Windows.Forms.Cursors.No
			e.AllowDrop = False
		End If
	Else
		' 項目を Group2 にコピーすることのみを許可します。
		If e.TargetGroup.Key = "Group2" Then
			Me.StatusBar1.Text = "Drop item here to move it."
			e.DragCursor = System.Windows.Forms.Cursors.Default
			e.AllowDrop = True
		Else
			' ステータス バーのテキストとカーソルを更新し、
			' 項目をターゲット グループに移動できないことを示します。
			Me.StatusBar1.Text = "Item cannot be dropped on Group '" + e.TargetGroup.Text + "'."
			e.DragCursor = System.Windows.Forms.Cursors.No
			e.AllowDrop = False
		End If
	End If
End Sub

C# の場合：

private void ultraExplorerBar1_ItemDragOver(object sender, Infragistics.Win.UltraWinExplorerBar.ItemDragOverEventArgs e)
{
	if(e.DragAction == Infragistics.Win.UltraWinExplorerBar.ItemDragAction.Copy)
	{
		// 項目を Group1 にコピーすることのみを許可します。
		if (e.TargetGroup.Key == "Group1")
		{
			this.statusBar1.Text = "Drop item here to copy it.";
			e.DragCursor = System.Windows.Forms.Cursors.Default;
			e.AllowDrop = true;
		}
		else
		{
			// ステータス バーのテキストとカーソルを更新し、
			// 項目をコピーできないことを示します。
			this.statusBar1.Text = "Item cannot be dropped on Group '" + e.TargetGroup.Text + "'.";
			e.DragCursor = System.Windows.Forms.Cursors.No;
			e.AllowDrop = false;
		}
	}
	else
	{
		// 項目を Group2 にコピーすることのみを許可します。
		if (e.TargetGroup.Key == "Group2")
		{
			this.statusBar1.Text = "Drop item here to move it.";
			e.DragCursor = System.Windows.Forms.Cursors.Default;
			e.AllowDrop = true;
		}
		else
		{
			// ステータス バーのテキストとカーソルを更新し、
			// 項目をターゲット グループに移動できないことを示します。
			this.statusBar1.Text = "Item cannot be dropped on Group '" + e.TargetGroup.Text + "'.";
			e.DragCursor = System.Windows.Forms.Cursors.No;
			e.AllowDrop = false;
		}
	}
}

ItemDropped - 項目のドラッグアンドドロップ操作が完了し、ドラッグされた項目が新しい位置を占めたときに発生します。パラメータには DragAction と OriginalGroup があります。DragAction は、項目がコピーされるか、または移動されるかを示す列挙値を渡します。OriginalGroup は、ドラッグアンドドロップを行う前に項目が属していたグループを示します。

Windows Forms | ヘルプ トピック

Items のドラッグ アンド ドロップのコントロール

Windows Forms | ヘルプトピック

Items のドラッグアンドドロップのコントロール