Control.Enabled Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si el control puede responder a la interacción del usuario.

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 propiedad

Boolean

Es true si el control puede responder a la interacción del usuario; en caso contrario, es false. De manera predeterminada, es true.

Ejemplos

En el ejemplo de código siguiente se crea un GroupBox objeto y se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox objeto y se establece su Location dentro del cuadro de grupo. A continuación, establece la Text propiedad del cuadro de grupo y acopla el cuadro de grupo en la parte superior del formulario. Por último, deshabilita el cuadro de grupo estableciendo la Enabled propiedad falseen , lo que hace que todos los controles contenidos en el cuadro de grupo se deshabiliten.

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

Comentarios

Con la Enabled propiedad , puede habilitar o deshabilitar controles en tiempo de ejecución. Por ejemplo, puede deshabilitar los controles que no se aplican al estado actual de la aplicación. También puede deshabilitar un control para restringir su uso. Por ejemplo, se puede deshabilitar un botón para impedir que el usuario haga clic en él. Si un control está deshabilitado, no se puede seleccionar.

Importante

Establecer la Enabled propiedad false en no deshabilita el cuadro de control de la aplicación ni impide que la ventana de la aplicación reciba el foco.

Cuando un control de contenedor tiene su propiedad habilitada establecida falseen , todos sus controles contenidos también están deshabilitados. Por ejemplo, si el usuario hace clic en cualquiera de los controles contenidos en un control deshabilitado GroupBox , no se generan eventos.

Nota:

Cuando se deshabilita un control desplazable, también se deshabilitan las barras de desplazamiento. Por ejemplo, un cuadro de texto multilínea deshabilitado no puede desplazarse para mostrar todas las líneas de texto.

Consulte también

• ScrollableControl