SplitContainer コントロールの概要 (Windows フォーム)

  • [アーティクル]

Windows フォームの SplitContainer コントロールは複合と考えることができ、移動可能なバーで区切られた 2 つのパネルです。 マウス ポインターがバーの上に移動すると、ポインターの形が変わり、バーが移動可能であることを示します。

重要

ツールボックスでは、SplitContainer コントロールが以前のバージョンの Visual Studio に存在した Splitter コントロールを置き換えます。 SplitContainer コントロールは Splitter コントロールより優先されます。 Splitter クラスは、既存のアプリケーションの互換性のために .NET Framework に含まれていますが、新しいプロジェクトでは SplitContainer コントロールを使用することを強くお勧めします。

SplitContainer コントロールを使用すると複雑なユーザー インターフェイスを作成できます。多くの場合、1 つのパネルでの選択項目によって、別のパネルに表示されるオブジェクトが決定します。 この配置は、情報の表示と参照に対して非常に効果的です。 2 つのパネルを使用することで、情報を領域に集約でき、バーまたは "スプリッター" により、ユーザーがパネルを簡単にサイズ変更できます。

複数の SplitContainer コントロールを入れ子にすることもできます。その場合、2 つ目の SplitContainer コントロールは水平方向に配置され、その上下にパネルが作成します。

SplitContainer コントロールは、既定ではキーボードからアクセスできることに注意してください。IsSplitterFixed プロパティが false に設定されている場合、ユーザーは方向キーを押してスプリッターを移動できます。

SplitContainer コントロールの Orientation プロパティは、コントロール自体ではなく、スプリッターの方向を決定します。 そのため、このプロパティが Vertical に設定されている場合、スプリッターは上から下に向かって配置され、その左右にパネルが作成されます。

なお、SplitterRectangle プロパティの値は、Orientation プロパティの値によって変わることに注意してください。 詳細については、SplitterRectangle プロパティを参照してください。

SplitContainer コントロールについては、サイズと移動を制限することもできます。 FixedPanel プロパティでは、SplitContainer コントロールのサイズが変更された後にも同じサイズで維持されるパネルを決定します。IsSplitterFixed プロパティでは、スプリッターをキーボードまたはマウスで移動できるようにするかどうかを決定します。

注意

true プロパティが IsSplitterFixed に設定されている場合でも、スプリッターをプログラムによって移動することはできます (たとえば、SplitterDistance プロパティを使用するなどして)。

最後に、SplitContainer コントロールの各パネルには、サイズを個別に決定するプロパティがあります。

一般的に使用されるプロパティ、メソッド、およびイベント

名前 説明
FixedPanel プロパティ SplitContainer コントロールのサイズを変更した後も、同じサイズのまま維持されるパネルを指定します。
IsSplitterFixed プロパティ キーボードまたはマウスを使用してスプリッターを移動できるようにするかどうかを指定します。
Orientation プロパティ スプリッターを垂直方向と水平方向のどちらに配置するかを指定します。
SplitterDistance プロパティ 左端または上端から、移動可能なスプリッター バーまでの距離を、ピクセル単位で指定します。
SplitterIncrement プロパティ ユーザーがスプリッターを移動できる最小距離をピクセル単位で指定します。
SplitterWidth プロパティ スプリッターの太さをピクセル単位で指定します。
SplitterMoving イベント スプリッターの移動中に発生します。
SplitterMoved イベント スプリッターの移動が完了したときに発生します。

関連項目