Control.Dock Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Získá nebo nastaví, které ohraničení ovládacího prvku jsou ukotveny do nadřazeného ovládacího prvku a určuje způsob změny velikosti ovládacího prvku s nadřazeným objektem.

public:
 virtual property System::Windows::Forms::DockStyle Dock { System::Windows::Forms::DockStyle get(); void set(System::Windows::Forms::DockStyle value); };

public virtual System.Windows.Forms.DockStyle Dock { get; set; }

member this.Dock : System.Windows.Forms.DockStyle with get, set

Public Overridable Property Dock As DockStyle

Hodnota vlastnosti

DockStyle

Jedna z DockStyle hodnot. Výchozí hodnota je None.

Výjimky

InvalidEnumArgumentException

Přiřazená hodnota není jednou z DockStyle hodnot.

Příklady

Následující příklad kódu vytvoří GroupBox a nastaví některé z jeho běžných vlastností. Příklad vytvoří TextBox a nastaví ho Location v rámci skupinového pole. Dále nastaví Text vlastnost skupinového rámečku a ukotví pole skupiny na začátek formuláře. Nakonec zakáže pole skupiny nastavením Enabled vlastnosti na false, což způsobí zakázání všech ovládacích prvků obsažených v poli skupiny.

   // 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 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = 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 );
   }

// 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);
}

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As 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.
   Me.Controls.Add(groupBox1)
End Sub

Poznámky

Dock Pomocí vlastnosti můžete definovat, jak se ovládací prvek automaticky změní, protože se změní velikost jeho nadřazeného ovládacího prvku. Například nastavení Dock , které způsobí, že DockStyle.Left se ovládací prvek zarovná s levými okraji nadřazeného ovládacího prvku a změní velikost při změně velikosti nadřazeného ovládacího prvku. Ovládací prvky jsou ukotvené v jejich pořadí Z, což je vizuální vrstvení ovládacích prvků ve formuláři podél osy Z (hloubka).

Ovládací prvek lze ukotvit na jeden okraj nadřazeného kontejneru nebo ho lze ukotvit na všechny okraje a vyplnit nadřazený kontejner.

Margin Nastavení vlastnosti u ukotveného ovládacího prvku nemá žádný vliv na vzdálenost ovládacího prvku od okrajů jeho kontejneru.

Poznámka:

Vlastnosti Anchor se Dock vzájemně vylučují. Najednou lze nastavit pouze jednu a poslední sada má přednost.

Poznámky pro dědice

Při přepsání Dock vlastnosti v odvozené třídě použijte vlastnost základní třídy Dock k rozšíření základní implementace. V opačném případě musíte zadat veškerou implementaci. Není nutné přepsat obě get metody Dock vlastnostiset. V případě potřeby můžete přepsat pouze jednu.

Viz také

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout