Control.HasChildren Control.HasChildren Control.HasChildren Control.HasChildren Property

Definition

Ruft einen Wert ab, der angibt, ob das Steuerelement ein oder mehrere untergeordnete Steuerelemente enthält.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

Eigenschaftswert

true, wenn das Steuerelement ein oder mehrere untergeordnete Steuerelemente enthält, andernfalls false.true if the control contains one or more child controls; otherwise, false.

Beispiele

Im folgenden Codebeispiel werden die BackColor und ForeColor der-Steuerelemente auf die Standardsystem Farben festgelegt.The following code example sets the BackColor and ForeColor of the controls to the default system colors. Der Code ruft rekursiv selbst auf, wenn das Steuerelement über untergeordnete Steuerelemente verfügt.The code recursively calls itself if the control has any child controls. Für dieses Codebeispiel ist es erforderlich, Form dass Sie über ein-Element mit mindestens einem untergeordneten Steuerelement verfügen. ein Panel unter GroupBoxgeordnetes Container Steuerelement, wie z. b. oder, mit einem untergeordneten Steuerelement (en) würde die Rekursion besser veranschaulichen.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

Hinweise

Wenn die Controls Count Auflistung größer als 0 (null) ist HasChildren , gibt die true-Eigenschaft zurück.If the Controls collection has a Count greater than zero, the HasChildren property will return true. Durch den HasChildren Zugriff auf die-Eigenschaft wird das Erstellen Control.ControlCollection einer nicht erzwungen, wenn das Steuerelement keine untergeordneten Elemente aufweist. Daher kann das verweisen auf diese Eigenschaft einen Leistungsvorteil beim Durchlaufen einer Struktur von Steuerelementen bieten.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.

Gilt für:

Siehe auch