Control.Enabled Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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.

Vedi anche

• ScrollableControl