Control.Enabled Propriedade

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.

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.

Aplica-se a

Confira também

• ScrollableControl