Control.Controls Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origine:: Control.cs

Origine:: Control.cs

Origine:: Control.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene la raccolta di controlli contenuti nel controllo.

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à

Control.ControlCollection

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.ControlCollection Controls della proprietà della maschera, derivata dalla Control classe .

È possibile modificare i controlli nell'oggetto Control.ControlCollection Controls Control.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

Prodotto	Versioni
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Condividi tramite