Control.Enabled Eigenschap

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

Waarde van eigenschap

true als het besturingselement kan reageren op gebruikersinteractie; anders, false. De standaardwaarde is true.

Voorbeelden

In het volgende codevoorbeeld worden enkele GroupBox algemene eigenschappen gemaakt en ingesteld. In het voorbeeld wordt een TextBox en ingesteld Location in het groepsvak. Vervolgens wordt de Text eigenschap van het groepsvak ingesteld en wordt het groepsvak aan de bovenkant van het formulier gekoppeld. Ten slotte wordt het groepsvak uitgeschakeld door de Enabled eigenschap falsein te stellen op, waardoor alle besturingselementen in het groepsvak worden uitgeschakeld.

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

Opmerkingen

Met de Enabled eigenschap kunt u besturingselementen tijdens runtime in- of uitschakelen. U kunt bijvoorbeeld besturingselementen uitschakelen die niet van toepassing zijn op de huidige status van de toepassing. U kunt ook een besturingselement uitschakelen om het gebruik ervan te beperken. Een knop kan bijvoorbeeld worden uitgeschakeld om te voorkomen dat de gebruiker erop klikt. Als een besturingselement is uitgeschakeld, kan het niet worden geselecteerd.

Wanneer voor een containerbesturingselement de ingeschakelde eigenschap is ingesteld false, worden ook alle ingesloten besturingselementen uitgeschakeld. Als de gebruiker bijvoorbeeld op een van de besturingselementen in een uitgeschakeld besturingselement GroupBox klikt, worden er geen gebeurtenissen gegenereerd.

Zie ook

• ScrollableControl