Практическое руководство. Добавление или удаление элемента в коллекции элементов управления во время выполнения

Стандартными задачами при разработке приложений являются добавление элементов управления и удаление элементов управления из любого контейнерного элемента управления в формах (например, элементов управления Panel или GroupBox или даже самой формы). Во время разработки элементы управления можно перетаскивать непосредственно на панель или в группу. Во время выполнения эти элементы управления поддерживают коллекцию Controls, которая отслеживает размещенные в них элементы управления.

Примечание.

Следующий пример кода применяется к любому элементу управления, который поддерживает внутри себя коллекцию элементов управления.

Программное добавление элемента управления в коллекцию

  1. Создайте экземпляр элемента управления, подлежащий добавлению.

  2. Задайте свойства нового элемента управления.

  3. Добавьте этот элемент управления в коллекцию Controls родительского элемента управления.

    В следующем примере кода демонстрируется создание экземпляра элемента управления Button. Необходима форма с элементом управления NewPanelButton_Click, уже должен существовать метод обработки событий для создаваемой кнопки Panel.

    Public NewPanelButton As New Button()  
    
    Public Sub AddNewControl()  
       ' The Add method will accept as a parameter any object that derives  
       ' from the Control class. In this case, it is a Button control.  
       Panel1.Controls.Add(NewPanelButton)  
       ' The event handler indicated for the Click event in the code
       ' below is used as an example. Substite the appropriate event  
       ' handler for your application.  
       AddHandler NewPanelButton.Click, AddressOf NewPanelButton_Click  
    End Sub  
    
    public Button newPanelButton = new Button();  
    
    public void addNewControl()  
    {
       // The Add method will accept as a parameter any object that derives  
       // from the Control class. In this case, it is a Button control.  
       panel1.Controls.Add(newPanelButton);  
       // The event handler indicated for the Click event in the code
       // below is used as an example. Substitute the appropriate event  
       // handler for your application.  
       this.newPanelButton.Click += new System.EventHandler(this. NewPanelButton_Click);  
    }  
    

Программное удаление элементов управления из коллекции

  1. Удалите обработчик событий из события. В Visual Basic используйте ключевое слово оператор RemoveHandler, в C# используйте оператор -=.

  2. Используйте метод Remove для удаления требуемого элемента управления из коллекции Controls панели.

  3. Вызовите метод Dispose, чтобы освободить все ресурсы, используемые элементом управления.

    Public Sub RemoveControl()  
    ' NOTE: The code below uses the instance of
    ' the button (NewPanelButton) from the previous example.  
       If Panel1.Controls.Contains(NewPanelButton) Then  
          RemoveHandler NewPanelButton.Click, AddressOf _
             NewPanelButton_Click  
          Panel1.Controls.Remove(NewPanelButton)  
          NewPanelButton.Dispose()  
       End If  
    End Sub  
    
    private void removeControl(object sender, System.EventArgs e)  
    {  
    // NOTE: The code below uses the instance of
    // the button (newPanelButton) from the previous example.  
       if(panel1.Controls.Contains(newPanelButton))  
       {  
          this.newPanelButton.Click -= new System.EventHandler(this.
             NewPanelButton_Click);  
          panel1.Controls.Remove(newPanelButton);  
          newPanelButton.Dispose();  
       }  
    }  
    

См. также