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

定義

コントロールに 1 つ以上の子コントロールが格納されているかどうかを示す値を取得します。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

プロパティ値

コントロールに 1 つ以上の子コントロールが格納されている場合は true。それ以外の場合は falsetrue if the control contains one or more child controls; otherwise, false.

コントロールのBackColorForeColorを既定のシステムカラーに設定するコード例を次に示します。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も1つの子コントロールを持つを持っている必要がありますPanelGroupBoxただし、またはのような子コンテナーコントロールは、独自の子コントロールを持つことで、再帰をより適切に示すことができます。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 HasChildren trueが0より大きい場合、プロパティはを返します。 CountIf 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.

適用対象

こちらもご覧ください