Control.Controls Własność

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

Control.cs

Pobiera kolekcję kontrolek zawartych w kontrolce.

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

Wartość nieruchomości

Control.ControlCollection

Reprezentująca Control.ControlCollection kolekcję kontrolek zawartych w kontrolce.

Atrybuty

BrowsableAttribute

Przykłady

Poniższy przykład kodu usuwa element Control z Control.ControlCollection klasy Panel pochodnej, jeśli jest elementem członkowskim kolekcji. Przykład wymaga utworzenia kontrolki Panel, , i Buttonco najmniej jednej RadioButton kontrolki na obiekcie Form. Kontrolki RadioButton są dodawane do kontrolki Panel , a kontrolka Panel dodana do kontrolki Form. Po kliknięciu przycisku przycisk radiowy o nazwie removeButton zostanie usunięty z elementu 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

Uwagi

Element Control może działać jako element nadrzędny do kolekcji kontrolek. Na przykład po dodaniu kilku kontrolek do Formelementu , każdy z kontrolek jest członkiem Control.ControlCollection przypisanej do Controls właściwości formularza, która pochodzi z Control klasy.

Kontrolki Control.ControlCollection przypisane do Controls właściwości można manipulować przy użyciu metod dostępnych w Control.ControlCollection klasie.

Podczas dodawania kilku kontrolek do kontrolki nadrzędnej zaleca się wywołanie SuspendLayout metody przed zainicjowaniem kontrolek do dodania. Po dodaniu kontrolek do kontrolki nadrzędnej wywołaj metodę ResumeLayout . Spowoduje to zwiększenie wydajności aplikacji z wieloma kontrolkami.

Controls Użyj właściwości , aby iterować wszystkie kontrolki formularza, w tym zagnieżdżone kontrolki. GetNextControl Użyj metody , aby pobrać poprzednią lub następną kontrolkę podrzędną w kolejności tabulacji. ActiveControl Użyj właściwości , aby pobrać lub ustawić aktywną kontrolkę kontenera.

Zobacz także

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