Control.Enabled Propriété

Définition

Obtient ou définit une valeur indiquant si un contrôle peut répondre à une interaction utilisateur.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

Valeur de propriété

true si le contrôle peut répondre à une interaction utilisateur ; sinon, false.true if the control can respond to user interaction; otherwise, false. La valeur par défaut est true.The default is true.

Exemples

L’exemple de code suivant crée un GroupBox et définit certaines de ses propriétés communes.The following code example creates a GroupBox and sets some of its common properties. L’exemple crée un TextBox et définit son Location dans la zone de groupe.The example creates a TextBox and sets its Location within the group box. Ensuite, il définit la propriété Text de la zone de groupe et ancre la zone de groupe en haut du formulaire.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Enfin, elle désactive la zone de groupe en affectant à la propriété Enabled la valeur false, ce qui entraîne la désactivation de tous les contrôles contenus dans la zone de groupe.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

Remarques

Avec la propriété Enabled, vous pouvez activer ou désactiver des contrôles au moment de l’exécution.With the Enabled property, you can enable or disable controls at run time. Par exemple, vous pouvez désactiver les contrôles qui ne s’appliquent pas à l’état actuel de l’application.For example, you can disable controls that do not apply to the current state of the application. Vous pouvez également désactiver un contrôle pour limiter son utilisation.You can also disable a control to restrict its use. Par exemple, un bouton peut être désactivé pour empêcher l’utilisateur de cliquer dessus.For example, a button can be disabled to prevent the user from clicking it. Si un contrôle est désactivé, il ne peut pas être sélectionné.If a control is disabled, it cannot be selected.

Important

La définition de la propriété Enabled sur false ne désactive pas la zone de contrôle de l’application ou n’empêche pas la fenêtre de l’application de recevoir le focus.Setting the Enabled property to false does not disable the application's control box or prevent the application window from receiving the focus.

Lorsqu’un contrôle conteneur a sa propriété Enabled définie sur false, tous les contrôles qu’il contient sont également désactivés.When a container control has its enabled property set to false, all its contained controls are disabled, as well. Par exemple, si l’utilisateur clique sur l’un des contrôles contenus dans un contrôle GroupBox désactivé, aucun événement n’est déclenché.For example, if the user clicks on any of the controls contained in a disabled GroupBox control, no events are raised.

Notes

Lorsqu’un contrôle à défilement est désactivé, les barres de défilement sont également désactivées.When a scrollable control is disabled, the scroll bars are also disabled. Par exemple, une zone de texte multiligne désactivée ne peut pas faire défiler pour afficher toutes les lignes de texte.For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

S’applique à

Voir aussi