Control.Enabled 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 o imposta un valore che indica se il controllo può rispondere all'interazione dell'utente.

public:
 property bool Enabled { bool get(); void set(bool value); };

public bool Enabled { get; set; }

member this.Enabled : bool with get, set

Public Property Enabled As Boolean

Valore della proprietà

Boolean

true se il controllo può rispondere all'interazione dell'utente; in caso contrario, false. Il valore predefinito è true.

Esempio

L'esempio di codice seguente crea un oggetto GroupBox e imposta alcune delle relative proprietà comuni. Nell'esempio viene creato un oggetto TextBox e viene impostato Location all'interno della casella di gruppo. Imposta quindi la Text proprietà della casella di gruppo e ancora la casella di gruppo viene ancorata alla parte superiore del modulo. Infine, disabilita la casella di gruppo impostando la Enabled proprietà su false, che causa la disabilitazione di tutti i controlli contenuti nella casella di gruppo.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

Commenti

Con la Enabled proprietà è possibile abilitare o disabilitare i controlli in fase di esecuzione. Ad esempio, è possibile disabilitare i controlli che non si applicano allo stato corrente dell'applicazione. È anche possibile disabilitare un controllo per limitare l'uso. Ad esempio, un pulsante può essere disabilitato per impedire all'utente di fare clic su di esso. Se un controllo è disabilitato, non può essere selezionato.

Importante

L'impostazione della Enabled proprietà su false non disabilita la casella di controllo dell'applicazione o impedisce alla finestra dell'applicazione di ricevere lo stato attivo.

Quando un controllo contenitore ha la proprietà abilitata impostata su false, tutti i controlli contenuti sono disabilitati, nonché. Ad esempio, se l'utente fa clic su uno dei controlli contenuti in un controllo disabilitato GroupBox , non vengono generati eventi.

Nota

Quando un controllo scorrevole è disabilitato, le barre di scorrimento sono disabilitate. Ad esempio, una casella di testo multilinea disabilitata non è in grado di scorrere per visualizzare tutte le righe di testo.

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

Vedi anche

ScrollableControl

Condividi tramite