この記事は翻訳者によって翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 |
訳文
原文
|
Control.Dock プロパティ
コントロールの境界のうち、親コントロールにドッキングする境界を取得または設定します。また、コントロールのサイズが親コントロール内でどのように変化するかを決定します。
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)
| 例外 | 条件 |
|---|---|
| InvalidEnumArgumentException |
代入された値が、DockStyle 値ではありません。 |
親コントロールのサイズ変更に合わせてコントロールのサイズを自動的に変更する方法を定義するには、Dock プロパティを使用します。 たとえば、Dock を DockStyle.Left に設定すると、コントロールが親コントロールの左端に揃えて配置され、親コントロールのサイズの変更に合わせてサイズ変更されます。 コントロールは、Z オーダーに基づいてドッキングされます。Z オーダーは、フォーム上に配置された各コントロールの Z 軸 (奥行) 方向の視覚的な重なり合いのことです。
コントロールは、親コンテナーの 1 つの端にドッキングすることも、すべての端にドッキングして親コンテナー全体を塗りつぶすこともできます。
ドッキングされたコントロールの Margin プロパティを設定しても、そのコンテナーの端からコントロールまでの距離には影響しません。
メモ
|
|---|
|
Anchor プロパティと Dock プロパティは同時には指定できません。 いずれか一方のみを設定でき、一度に両方のプロパティを設定した場合は、最後に設定された方が優先されます。 |
継承時の注意
派生クラスで Dock プロパティをオーバーライドする場合は、基本クラスの Dock プロパティを使用して、基本の実装を拡張します。 それ以外の場合は、すべての実装を提供する必要があります。 Dock プロパティの get メソッドと set メソッドの両方をオーバーライドする必要はありません。必要に応じて 1 つだけをオーバーライドできます。
GroupBox を作成して、共通プロパティの一部を設定するコード例を次に示します。 この例では、TextBox を作成し、グループ ボックス内での Location を設定しています。 次に、グループ ボックスの Text プロパティを設定して、グループ ボックスをフォームの上部にドッキングします。 最後に、Enabled プロパティを false に設定してグループを無効にします。これにより、グループ ボックスに含まれるすべてのコントロールが無効になります。
// Add a GroupBox to a form and set some of its common properties. private void AddMyGroupBox() { // Create a GroupBox and add a TextBox to it. GroupBox groupBox1 = new GroupBox(); TextBox textBox1 = new TextBox(); textBox1.Location = new Point(15, 15); groupBox1.Controls.Add(textBox1); // Set the Text and Dock properties of the GroupBox. groupBox1.Text = "MyGroupBox"; groupBox1.Dock = DockStyle.Top; // Disable the GroupBox (which disables all its child controls) groupBox1.Enabled = false; // Add the Groupbox to the form. this.Controls.Add(groupBox1); }
Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2
.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
