Control.HasChildren Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Obtient une valeur indiquant si le contrôle contient un ou plusieurs contrôles enfants.

C#

[System.ComponentModel.Browsable(false)]
public bool HasChildren { get; }

Valeur de propriété

Boolean

true si le contrôle contient un ou plusieurs contrôles enfants ; sinon, false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant définit le BackColor et ForeColor des contrôles sur les couleurs système par défaut. Le code s’appelle de manière récursive si le contrôle a des contrôles enfants. Cet exemple de code nécessite que vous disposiez d’un Form avec au moins un contrôle enfant ; toutefois, un contrôle conteneur enfant, comme un Panel ou GroupBox, avec ses propres contrôles enfants serait mieux montrer la récursivité.

C#

// Reset all the controls to the user's default Control color. 
private void ResetAllControlsBackColor(Control control)
{
   control.BackColor = SystemColors.Control;
   control.ForeColor = SystemColors.ControlText;
   if(control.HasChildren)
   {
      // Recursively call this method for each child control.
      foreach(Control childControl in control.Controls)
      {
         ResetAllControlsBackColor(childControl);
      }
   }
}

Remarques

Si la Controls collection a une Count valeur supérieure à zéro, la HasChildren propriété retourne true. L’accès à la HasChildren propriété ne force pas la création d’un Control.ControlCollection si le contrôle n’a pas d’enfants. Le référencement de cette propriété peut donc fournir un avantage en matière de performances lors de la marche à pied d’une arborescence de contrôles.

S’applique à

Voir aussi

• Count