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 de Propriedade

true se o controlo conseguir responder à interação do utilizador; caso contrário, false. A predefinição é true.

Exemplos

O seguinte exemplo de código cria um GroupBox e define algumas das suas propriedades comuns. O exemplo cria um TextBox e define o seu Location dentro da caixa do grupo. De seguida, define a Text propriedade da caixa de grupo e encaixa a caixa de grupo no topo do formulário. Por fim, desativa a caixa de grupo ao definir a Enabled propriedade para false, o que faz com que todos os controlos contidos na caixa de grupo fiquem desativados.

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

Observações

Com a Enabled propriedade, pode ativar ou desativar os controlos em tempo de execução. Por exemplo, pode desativar controlos que não se aplicam ao estado atual da aplicação. Também podes desativar um controlo para restringir o seu uso. Por exemplo, um botão pode ser desativado para impedir que o utilizador clique nele. Se um controlo estiver desativado, não pode ser selecionado.

Quando um controlo de contentor tem a sua propriedade ativada definida para false, todos os seus controlos contidos também são desativados. Por exemplo, se o utilizador clicar em qualquer um dos controlos contidos num controlo GroupBox desativado, nenhum evento é gerado.

Ver também

• ScrollableControl