TabDragOver イベント

指定した位置が有効なドロップ ポイントかどうかを決定するために、MdiTab のドラッグ中に発生するイベント。

シンタックス

Visual Basic

'宣言
 
Public Event TabDragOver As MdiTabDragOverEventHandler

C#

public event MdiTabDragOverEventHandler TabDragOver

イベント データ

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

プロパティ	解説
AllowDrop	Tab をこの位置にドロップできるかどうかを取得または設定します。
DragCursor	この位置に表示する System.Windows.Forms.Cursor を返すか、設定します。デフォルトカーソルを表示するには、これをnullのままにしておきます。
DropAction	マウスがこの位置で離された場合に実行されるアクションを返します。
Orientation	新しいグループの方向を返します。
Point	処理される、画面座標内でのマウスの位置。
RelativePosition	TabGroup に対する新しいグループの相対的な位置を返します。
Tab	ドラッグされている MdiTab を返します。
TabGroup	ドラッグされている Tab の下にある MdiTabGroup を返します。マウスが TabGroup の上にない場合は null を返します。

解説

TabDragOver イベントは、Tab のドラッグ操作中にマウスが有効なドロップ位置に置かれたときに呼び出されます。この位置が有効なドロップ ポイントでないことをエンドユーザーに示すため、MdiTabDragOverEventArgs.AllowDrop を True に設定できます。また、MdiTabDragOverEventArgs.DragCursor を使用して、表示されるカーソルを初期化できます。DropAction は、タブがこの MdiTabDragOverEventArgs.Point で離された場合に実行されるアクションを示します。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabbedMdi

Private Sub ultraTabbedMdiManager1_TabDragOver(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTabbedMdi.MdiTabDragOverEventArgs) Handles ultraTabbedMdiManager1.TabDragOver
    ' The 'TabDragOver' event is invoked during a drag operation
    ' as the mouse is repositioned. The 'DropAction' indicates
    ' the action that will be taken if the mouse is released
    ' at this point.
    '

    Select Case e.DropAction
        Case MdiTabDropAction.TabGroup
            ' if the tab came from another tab group
            ' is attempting to drag it over an edit group,
            ' then prevent the drop
            If Not e.TabGroup Is e.Tab.TabGroup AndAlso e.TabGroup.Key = "Edit" Then
                ' The 'AllowDrop' may be set to false to indicate
                ' that the specified point is not a valid drop location.
                e.AllowDrop = False

                ' The 'DragCursor' may be used to show a specific cursor 
                ' for the 'Point' being processed.
                e.DragCursor = Cursors.No
            End If
            Exit Sub
        Case MdiTabDropAction.NewHorizontalGroup
        Case MdiTabDropAction.NewVerticalGroup
            ' the point must be over a splitter bar
            ' or near the edge of the mdi client area
            Exit Sub
        Case MdiTabDropAction.ContextMenu
            ' prevent the display of a context menu if
            ' the mouse is released within the mdi client area
            e.AllowDrop = False
            Exit Sub
    End Select
End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabbedMdi;

private void ultraTabbedMdiManager1_TabDragOver(object sender, Infragistics.Win.UltraWinTabbedMdi.MdiTabDragOverEventArgs e)
{
	// The 'TabDragOver' event is invoked during a drag operation
	// as the mouse is repositioned. The 'DropAction' indicates
	// the action that will be taken if the mouse is released
	// at this point.
	//

	switch(e.DropAction)
	{
		case MdiTabDropAction.TabGroup:
		{
			// if the tab came from another tab group
			// is attempting to drag it over an edit group,
			// then prevent the drop
			if (e.TabGroup != e.Tab.TabGroup && 
				e.TabGroup.Key == "Edit")
			{
				// The 'AllowDrop' may be set to false to indicate
				// that the specified point is not a valid drop location.
				e.AllowDrop = false;

				// The 'DragCursor' may be used to show a specific cursor 
				// for the 'Point' being processed.
				e.DragCursor = Cursors.No;
			}
			break;
		}
		case MdiTabDropAction.NewHorizontalGroup:
		case MdiTabDropAction.NewVerticalGroup:
			// the point must be over a splitter bar
			// or near the edge of the mdi client area
			break;
		case MdiTabDropAction.ContextMenu:
			// prevent the display of a context menu if
			// the mouse is released within the mdi client area
			e.AllowDrop = false;
			break;
	}
}