Control.Enabled Control.Enabled Control.Enabled Control.Enabled Property

Definição

Obtém ou define um valor que indica se o controle pode responder à interação do usuário.Gets or sets a value indicating whether the control can respond to user interaction.

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

true se o controle puder responder à interação do usuário; caso contrário, false.true if the control can respond to user interaction; otherwise, false. O padrão é true.The default is true.

Exemplos

O exemplo de código a seguir GroupBox cria um e define algumas de suas propriedades comuns.The following code example creates a GroupBox and sets some of its common properties. O exemplo cria um TextBox e define seu Location na caixa de grupo.The example creates a TextBox and sets its Location within the group box. Em seguida, ele define Text a propriedade da caixa de grupo e encaixa a caixa de grupo na parte superior do formulário.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Por fim, ele desabilita a caixa de grupo definindo a Enabled Propriedade como false, o que faz com que todos os controles contidos na caixa de grupo sejam desabilitados.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // 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.With the Enabled property, you can enable or disable controls at run time. Por exemplo, você pode desabilitar controles que não se aplicam ao estado atual do aplicativo.For example, you can disable controls that do not apply to the current state of the application. Você também pode desabilitar um controle para restringir seu uso.You can also disable a control to restrict its use. Por exemplo, um botão pode ser desabilitado para impedir que o usuário o clique.For example, a button can be disabled to prevent the user from clicking it. Se um controle estiver desabilitado, ele não poderá ser selecionado.If a control is disabled, it cannot be selected.

Importante

Definir a Enabled Propriedade como false não desabilita a caixa de controle do aplicativo ou impede que a janela do aplicativo receba o foco.Setting the Enabled property to false does not disable the application's control box or prevent the application window from receiving the focus.

Quando um controle de contêiner tem sua propriedade Enabled definida falsecomo, todos os controles contidos também são desabilitados.When a container control has its enabled property set to false, all its contained controls are disabled, as well. Por exemplo, se o usuário clicar em qualquer um dos controles contidos em um controle GroupBox desabilitado, nenhum evento será gerado.For example, if the user clicks on any of the controls contained in a disabled GroupBox control, no events are raised.

Observação

Quando um controle rolável é desabilitado, as barras de rolagem também são desabilitadas.When a scrollable control is disabled, the scroll bars are also disabled. Por exemplo, uma caixa de texto de várias linhas desabilitada não pode rolar para exibir todas as linhas de texto.For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

Aplica-se a

Veja também