Control.HasChildren プロパティ

定義

コントロールに 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.

属性

次のコード例では、コントロールの 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. このコード例では、少なくとも1つの子コントロールを持つ Form が必要です。ただし、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 コレクションの Count が0よりも大きい場合、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.

適用対象

こちらもご覧ください