Control.Controls Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает коллекцию элементов управления, содержащихся в элементе управления.

public:
 property System::Windows::Forms::Control::ControlCollection ^ Controls { System::Windows::Forms::Control::ControlCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control.ControlCollection Controls { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Windows.Forms.Control.ControlCollection

Public ReadOnly Property Controls As Control.ControlCollection

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

Control.ControlCollection

Объект Control.ControlCollection представляет коллекцию элементов управления, содержащихся в элементе управления.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода удаляется Control из Control.ControlCollection производного класса Panel , если он является членом коллекции. В этом примере требуется, чтобы вы создали Panelэлемент управления , а Buttonтакже хотя бы один RadioButton элемент управления.Form Элементы RadioButton управления добавляются в Panel элемент управления, а Panel элемент управления добавляется в элемент Formуправления. При нажатии кнопки имя removeButton переключателя удаляется из элемента Control.ControlCollection.

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

Комментарии

Элемент управления Control может выступать в качестве родительского элемента управления. Например, при добавлении Formнескольких элементов управления в элемент управления каждый элемент управления является членом Control.ControlCollection назначенного Controls свойству формы, которое является производным от Control класса.

Вы можете управлять элементами управления, Control.ControlCollection назначенными Controls свойству, с помощью методов, доступных Control.ControlCollection в классе.

При добавлении нескольких элементов управления в родительский элемент управления рекомендуется вызвать SuspendLayout метод перед инициализацией добавляемых элементов управления. После добавления элементов управления в родительский элемент управления вызовите ResumeLayout метод. Это приведет к повышению производительности приложений с множеством элементов управления.

Controls Используйте свойство для итерации по всем элементам управления формы, включая вложенные элементы управления. GetNextControl Используйте метод для получения предыдущего или следующего дочернего элемента управления в порядке табуляции. ActiveControl Используйте свойство, чтобы получить или задать активный элемент управления контейнером.

См. также раздел

• Control.ControlCollection
• CreateControlsInstance()
• SuspendLayout()
• ResumeLayout()