Control.Dock Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví, které ohraničení ovládacího prvku je ukotvené do nadřazeného ovládacího prvku a určuje, jak je ovládací prvek změněn pomocí nadřazeného prvku.

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í formát 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í. Tento příklad vytvoří TextBox a nastaví jeho Location v rámci skupinového pole. Dále nastaví Text vlastnost pole skupiny 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í na velikost nadřazeného ovládacího prvku. Například nastavení Dock , které DockStyle.Left způsobí, že se ovládací prvek zarovná s levými okraji nadřazeného ovládacího prvku a změní velikost 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 formuláře (hloubka).

Ovládací prvek lze ukotvit na jeden okraj nadřazeného kontejneru nebo 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 je možné nastavit jenom 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. Jinak musíte zadat veškerou implementaci. Není nutné přepsat jak vlastnosti, get set tak metody Dock . V případě potřeby můžete přepsat pouze jednu.

Platí pro

Viz také