ドッキング／フローティングの動作を一元管理する C1DockingManager コンポーネント

(1) 特定のドッキングタブページをフローティングさせないようにする

特定のドッキングタブページがフローティング状態に移行するときに、Floating イベントが発生します。e.DockingTabPage イベント引数にてソースとなるタブページを取得でき、e.Cancel イベント引数に True を設定することで、フローティング状態への移行をキャンセルるすることもできます。

以下の例は、Floating イベントを使用して、tabPage1 がフローティング状態になるのを抑制します。

[C#]

private void docManager1_Floating(object sender, FloatingEventArgs e)
{
if (e.DockingTabPage == tabPage1)
e.Cancel = true;
}

[VB]

Private Sub dockManager1_Floating(sender As Object, e As FloatingEventArgs) Handles dockManager1.Floating
If e.DockingTabPage Is tabPage1 Then
e.Cancel = True
End If
End Sub

(2) 特定のドッキングタブ上にドラッグした場合にのみドッキングアンカーを表示する

ドッキングタブページのドッキング先を限定するには、QueryEnabledAnchors イベントを使用して選択可能なドッキングアンカーを制御するのが簡単です。e.SourceDockingTabPage イベント引数にてソースとなるドッキングタブページを、また e.DockingTabUnderCursor イベント引数にてドラッグ中のマウスカーソルの位置にあるドッキングタブをチェックし、必要に応じて e.Anchors イベント引数に対し有効なドッキングアンカーを設定します。

以下の例は、QueryEnabledAnchors イベントを使用して、tabPage1 が tabLeft 上にドラッグされているときのみ、その内部へのドッキングを許可するドッキングアンカーを表示します。それ以外の場合はドッキングアンカーを表示しないようにすることで、ドッキング可能なタブを限定しています。

[C#]

private void docManager1_QueryEnabledAnchors(object sender, DockingAnchorsEventArgs e)
{
if (e.SourceDockingTabPage == tabPage1)
if (e.DockingTabUnderCursor == tabLeft)
e.Anchors = Anchors.DiamondAll;
else
e.Anchors = Anchors.None;
}

[VB]

Private Sub dockManager1_QueryEnabledAnchors(sender As Object, e As DockingAnchorsEventArgs) Handles dockManager1.QueryEnabledAnchors
If e.SourceDockingTabPage Is tabPage1 Then
If e.DockingTabUnderCursor Is tabLeft Then
e.Anchors = Anchors.DiamondAll
Else
e.Anchors = Anchors.None
End If
End If
End Sub

(3) 動的なフローティングウィンドウが生成されたことを検出する

あるドッキングタブページがフローティング状態になると、フローティングウィンドウが動的に生成されます。またこのとき、FloatingWindowCreated イベントが発生し、e.Form イベント引数を参照することで生成されたフォームのインスタンスにアクセスできます。このインスタンスは通常、１つの C1DockingTab コントロールを子コントロールとして持っていますが、C1DockingTab がフローティング状態になった場合はそのオブジェクト自身、C1DockingTabPage がフローティング状態になった場合は動的に作成されたインスタンスとなります。

以下の例は、FloatingWindowCreated イベントを使用して、C1DockingTabPage がフローティング状態になったときに、その VisualStyle プロパティを Office2007Black に変更します。

[C#]

private void docManager1_FloatingWindowCreated(object sender, FloatingWindowCreatedEventArgs e)
{
if (e.Form != null && e.Form.Controls.Count > 0)
{
var tab = e.Form.Controls[0] as C1DockingTab;
if(tab != null && !tab.Name.StartsWith("tab"))
tab.VisualStyle = VisualStyle.Office2007Black;
}
}

[VB]

Private Sub dockManager1_FloatingWindowCreated(sender As Object, e As FloatingWindowCreatedEventArgs) Handles dockManager1.FloatingWindowCreated
If Not e.Form Is Nothing AndAlso e.Form.Controls.Count > 0 Then
Dim tab = CType(e.Form.Controls(0), C1DockingTab)
If Not tab Is Nothing AndAlso Not tab.Name.StartsWith("tab") Then
tab.VisualStyle = VisualStyle.Office2007Black
End If
End If
End Sub

今回紹介しましたイベントのほか、タブを閉じる動作の検出および抑制、タブページ等がドラッグ中かどうかの検出など、C1DockingManager コンポーネントを使用することで、ドッキング／フローティング動作をはじめとするさまざまななアクションの検出および制御を簡単に行うことができます。