Control.Controls Proprietà

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

Valore della proprietà

Raccolta Control.ControlCollection che rappresenta la raccolta di controlli contenuti nel controllo.

Attributi

BrowsableAttribute

Esempio

Nell'esempio Control.ControlCollection di codice seguente viene rimosso un Control oggetto dalla classe Panel derivata se è un membro della raccolta. L'esempio richiede che sia stato creato un Panelcontrollo , e Buttonalmeno un RadioButton controllo in un Formoggetto . I RadioButton controlli vengono aggiunti al Panel controllo e il Panel controllo aggiunto a Form. Quando si fa clic sul pulsante, il pulsante di opzione denominato removeButton viene rimosso dall'oggetto 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

Commenti

Un Control oggetto può fungere da padre a una raccolta di controlli. Ad esempio, quando vengono aggiunti diversi controlli a un Formoggetto , ognuno dei controlli è un membro Control.ControlCollectionControls della proprietà della maschera, derivata dalla Control classe .

È possibile modificare i controlli nell'oggetto Control.ControlCollectionControlsControl.ControlCollection assegnato alla proprietà usando i metodi disponibili nella classe .

Quando si aggiungono diversi controlli a un controllo padre, è consigliabile chiamare il SuspendLayout metodo prima di inizializzare i controlli da aggiungere. Dopo aver aggiunto i controlli al controllo padre, chiamare il ResumeLayout metodo . In questo modo si aumenteranno le prestazioni delle applicazioni con molti controlli.

Usare la proprietà per eseguire l'iterazione Controls di tutti i controlli di una maschera, inclusi i controlli annidati. Utilizzare il metodo per recuperare il GetNextControl controllo figlio precedente o successivo nell'ordine di tabulazioni. Utilizzare la ActiveControl proprietà per ottenere o impostare il controllo attivo di un controllo contenitore.

Si applica a

Vedi anche

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