Control.Enabled Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o controle pode responder à interação do usuário.

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

Valor da propriedade

Boolean

true se o controle puder responder à interação do usuário; caso contrário, false. O padrão é true.

Exemplos

O exemplo de código a seguir cria um GroupBox e define algumas de suas propriedades comuns. O exemplo cria um TextBox e define-o Location dentro da caixa de grupo. Em seguida, ele define a Text propriedade da caixa de grupo e encaixa a caixa de grupo na parte superior do formulário. Por fim, ele desabilita a caixa de grupo definindo a propriedade como false, o Enabled que faz com que todos os controles contidos na caixa de grupo sejam desabilitados.

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

Comentários

Com a Enabled propriedade, você pode habilitar ou desabilitar controles em tempo de execução. Por exemplo, você pode desabilitar controles que não se aplicam ao estado atual do aplicativo. Você também pode desabilitar um controle para restringir seu uso. Por exemplo, um botão pode ser desabilitado para impedir que o usuário clique nele. Se um controle estiver desabilitado, ele não poderá ser selecionado.

Importante

Definir a Enabled propriedade para false não desabilitar a caixa de controle do aplicativo ou impedir que a janela do aplicativo receba o foco.

Quando um controle de contêiner tem sua propriedade habilitada definida como false, todos os seus controles contidos também são desabilitados. Por exemplo, se o usuário clicar em qualquer um dos controles contidos em um controle desabilitado GroupBox , nenhum evento será gerado.

Observação

Quando um controle rolável é desabilitado, as barras de rolagem também são desabilitadas. Por exemplo, uma caixa de texto de várias linhas desabilitada não pode rolar para exibir todas as linhas de texto.

Confira também

• ScrollableControl