Control.Controls Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Získá kolekci ovládacích prvků obsažených v ovládacím prvku.

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

Hodnota vlastnosti

Control.ControlCollection

Představuje Control.ControlCollection kolekci ovládacích prvků obsažených v ovládacím prvku.

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu odebere Control z Control.ControlCollection odvozené třídy Panel , pokud je členem kolekce. Tento příklad vyžaduje, abyste vytvořili Panelovládací prvek , aspoň Buttonjeden RadioButton ovládací prvek .Form Ovládací RadioButton prvky jsou přidány do Panel ovládacího prvku a Panel ovládací prvek přidán do Form. Po kliknutí na tlačítko je přepínač s názvem removeButton odebrán z Control.ControlCollectiontlačítka .

   // 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

Poznámky

A Control může fungovat jako nadřazený objekt pro kolekci ovládacích prvků. Například při přidání několika ovládacích prvků do Form, každý z ovládacích prvků je členem přiřazené Control.ControlCollectionControls vlastnosti formuláře, která je odvozena z Control třídy.

Ovládací prvky přiřazené Control.ControlCollection k Controls vlastnosti můžete manipulovat pomocí metod dostupných ve Control.ControlCollection třídě.

Při přidávání několika ovládacích prvků do nadřazeného ovládacího prvku se doporučuje volat metodu SuspendLayout před inicializací ovládacích prvků, které se mají přidat. Po přidání ovládacích prvků do nadřazeného ovládacího prvku zavolejte metodu ResumeLayout . Tím se zvýší výkon aplikací s mnoha ovládacími prvky.

Controls Pomocí vlastnosti iterujte všechny ovládací prvky formuláře, včetně vnořených ovládacích prvků. Použijte metodu GetNextControl k načtení předchozího nebo dalšího podřízeného ovládacího prvku v pořadí ovládacích prvků. ActiveControl Pomocí vlastnosti můžete získat nebo nastavit aktivní ovládací prvek ovládacího prvku kontejneru.

Viz také

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