Control.HasChildren Propriedade

Definição

Obtém um valor que indica se o controle contém um ou mais controles filho.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

Valor da propriedade

true se o controle contiver um ou mais controles filho; caso contrário, false.true if the control contains one or more child controls; otherwise, false.

Atributos

Exemplos

O exemplo de código a seguir define o BackColor e ForeColor dos controles para as cores padrão do sistema.The following code example sets the BackColor and ForeColor of the controls to the default system colors. O código chama-se recursivamente se o controle tem controles filho.The code recursively calls itself if the control has any child controls. Este exemplo de código requer que você tenha um Form com pelo menos um controle filho; no entanto, um controle de contêiner filho, como um Panel ou GroupBox, com seus próprios controles filho demonstraria melhor a recursão.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

Comentários

Se a coleção de Controls tiver um Count maior que zero, a propriedade HasChildren retornará true.If the Controls collection has a Count greater than zero, the HasChildren property will return true. O acesso à propriedade HasChildren não força a criação de um Control.ControlCollection se o controle não tiver filhos, então fazer referência a essa propriedade pode fornecer um benefício de desempenho ao percorrer uma árvore de controles.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.

Aplica-se a

Veja também