DockStyle DockStyle DockStyle DockStyle Enum

Définition

Indique le positionnement de l'ancrage d'un contrôle.Specifies the position and manner in which a control is docked.

public enum class DockStyle
public enum DockStyle
type DockStyle = 
Public Enum DockStyle
Héritage

Champs

Bottom Bottom Bottom Bottom 2

Le bord inférieur du contrôle est ancré à la partie inférieure de son contrôle contenant.The control's bottom edge is docked to the bottom of its containing control.

Fill Fill Fill Fill 5

Tous les bords du contrôle sont ancrés à tous les bords de son contrôle contenant, tout en faisant l'objet d'un redimensionnement sur mesure.All the control's edges are docked to the all edges of its containing control and sized appropriately.

Left Left Left Left 3

Le bord gauche du contrôle est ancré au bord gauche de son contrôle contenant.The control's left edge is docked to the left edge of its containing control.

None None None None 0

Le contrôle n'est pas ancré.The control is not docked.

Right Right Right Right 4

Le bord droit du contrôle est ancré au bord droit de son contrôle contenant.The control's right edge is docked to the right edge of its containing control.

Top Top Top Top 1

Le bord supérieur du contrôle est ancré à la partie supérieure de son contrôle contenant.The control's top edge is docked to the top of its containing control.

Exemples

L’exemple suivant crée un GroupBox et définit certaines de ses propriétés communes.The following example creates a GroupBox and sets some of its common properties. L’exemple crée un TextBox et définit son Location contenu dans la zone de groupe.The example creates a TextBox and sets its Location within the group box. Ensuite, il définit la Text propriété de la zone de groupe et ancre la zone de groupe au début du formulaire.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Enfin, elle désactive la zone de groupe en affectant à Enabled falsela propriété la valeur, ce qui entraîne la désactivation de tous les contrôles contenus dans la zone de groupe.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // 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

Remarques

Lorsqu’un contrôle est ancré à un bord de son conteneur, il est toujours positionné sur ce bord lorsque le conteneur est redimensionné.When a control is docked to an edge of its container, it is always positioned flush against that edge when the container is resized. Si plusieurs contrôles sont ancrés à un bord, les contrôles s’affichent côte à côte en fonction de leur ordre de plan; les contrôles situés plus haut dans l’ordre de plan sont positionnés plus loin du bord du conteneur.If more than one control is docked to an edge, the controls appear side by side according to their z-order; controls higher in the z-order are positioned farther from the container's edge.

Si gauche, droite, haut ou bas est sélectionné, les bords spécifiés et opposés du contrôle sont redimensionnés en fonction de la taille des bords correspondants du contrôle conteneur.If Left, Right, Top, or Bottom is selected, the specified and opposite edges of the control are resized to the size of the containing control's corresponding edges. Si Fill est sélectionné, les quatre côtés du contrôle sont redimensionnés pour correspondre aux bords du contrôle conteneur.If Fill is selected, all four sides of the control are resized to match the containing control's edges.

S’applique à

Voir aussi