ドッキングされる側のパネル DockPanelの作成

DockPanelの構造

DockPanelはドッキングウィンドウのコンテナとなるコントロールであり、次の5つのDockWindowに分割されます。

top
bottom
left
right
document

DockPanelのフォームへの配置

ドッキングウィンドウを使用するには、それをドッキングさせるためのパネル (DockPanel) を、親となるフォーム上に配置する必要があります。

Visual Studioのデザイナで操作するには、まずDockPanelをツールボックスに追加します。

DockPanelコンポーネントのツールボックスへの登録

ツールボックスへ追加するには、[ツールボックス]ウィンドウのコンテキストメニューから[アイテムの選択]をクリックします。

[.NET Framework コンポーネント]タブの[参照]ボタンから、ライブラリのファイルを選択します。
ツールボックスアイテムの選択

「WeifenLuo.WinFormsUI.Docking.dll」ファイルを開きます。
Docking.dllを開く

ツールボックスにDockPanelが追加されます。
ツールボックスに追加されたDockPanel

フォームへの配置

ツールボックスに追加されたDockPanelコンポーネントを、フォーム上に配置します。

DockPanelの設定

DockPanel のプロパティ
プロパティ	説明	型
Contents	IDockContentフォームのコレクション。これには所有するドッキングウィンドウのリストが含まれる。	DockContentCollection
Panes	DockPaneウィンドウのコレクション。	DockPaneCollection
DocumentStyle		DocumentStyles

※ DockPaneクラスとは、タブ表示されたDockContentのコレクションを有するクラスです。

基本的な設定は、プロパティウィンドウから行えます。
DockPanelのプロパティ

パネルの表示スタイル

パネルの表示スタイルはDocumentStyleプロパティで設定します。

DocumentStyles 列挙型
メンバー	表示イメージ
DockingMdi	DockPanelはMDIの子コントロールである必要がある。 ^※1
DockingWindow	DockPanelはMDIの子コントロールである必要はない。
DockingSdi	Document形式のウィンドウが1つしかない場合には、タブを表示しない。
SystemMdi

※1 さもなくばエラーとなる「Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.」

ウィンドウの既定サイズ

ドッキングされるウィンドウの既定のサイズは、次のプロパティで設定します。

DockLeftPortion
DockRightPortion
DockTopPortion
DockBottomPortion

これらには0.0～1.0の範囲で、DockPanelのサイズに対する割合で指定します。

ページの上部へ

DockPanel Suiteの使用方法