Control.HasChildren Свойство

Определение

Возвращает значение, указывающее, содержит ли элемент управления один или несколько дочерних элементов.Gets a value indicating whether the control contains one or more child controls.

public:
 property bool HasChildren { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool HasChildren { get; }
member this.HasChildren : bool
Public ReadOnly Property HasChildren As Boolean

Значение свойства

Значение true, если элемент управления содержит один или несколько элементов; в противном случае — значение false.true if the control contains one or more child controls; otherwise, false.

Атрибуты

Примеры

В следующем примере кода BackColor и ForeColor для элементов управления устанавливаются в системные цвета по умолчанию.The following code example sets the BackColor and ForeColor of the controls to the default system colors. Код рекурсивно вызывает себя, если у элемента управления есть дочерние элементы управления.The code recursively calls itself if the control has any child controls. Этот пример кода требует наличия Form с по крайней мере одним дочерним элементом управления. Однако элемент управления дочерним контейнером, например Panel или GroupBox с собственными дочерними элементами управления, лучше продемонстрировать рекурсию.This code example requires that you have a Form with at least one child control; however, a child container control, like a Panel or GroupBox, with its own child control(s) would better demonstrate the recursion.

   // 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.
         IEnumerator^ myEnum = control->Controls->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            Control^ childControl = safe_cast<Control^>(myEnum->Current);
            ResetAllControlsBackColor( childControl );
         }
      }
   }
// 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);
      }
   }
}
' Reset all the controls to the user's default Control color. 
Private Sub ResetAllControlsBackColor(control As Control)
   control.BackColor = SystemColors.Control
   control.ForeColor = SystemColors.ControlText
   If control.HasChildren Then
      ' Recursively call this method for each child control.
      Dim childControl As Control
      For Each childControl In  control.Controls
         ResetAllControlsBackColor(childControl)
      Next childControl
   End If
End Sub

Комментарии

Если коллекция Controls имеет Count больше нуля, свойство HasChildren возвратит true.If the Controls collection has a Count greater than zero, the HasChildren property will return true. Доступ к свойству HasChildren не приводит к принудительному созданию Control.ControlCollection, если у элемента управления нет дочерних элементов, поэтому ссылка на это свойство может повысить производительность при прохождении дерева элементов управления.Accessing the HasChildren property does not force the creation of a Control.ControlCollection if the control has no children, so referencing this property can provide a performance benefit when walking a tree of controls.

Применяется к

Дополнительно