Control.Enabled Egenskap

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

Egenskapsvärde

trueom kontrollen kan svara på användarinteraktion; annars . false Standardvärdet är true.

Exempel

Följande kodexempel skapar en GroupBox och anger några av dess gemensamma egenskaper. Exemplet skapar en TextBox och anger dess Location i grupprutan. Därefter anger den Text egenskapen för grupprutan och dockar grupprutan överst i formuläret. Slutligen inaktiveras grupprutan genom att egenskapen anges Enabled till false, vilket gör att alla kontroller i grupprutan inaktiveras.

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

Kommentarer

Med egenskapen Enabled kan du aktivera eller inaktivera kontroller vid körning. Du kan till exempel inaktivera kontroller som inte gäller för programmets aktuella tillstånd. Du kan också inaktivera en kontroll för att begränsa dess användning. En knapp kan till exempel inaktiveras för att förhindra att användaren klickar på den. Om en kontroll är inaktiverad kan den inte väljas.

När en containerkontroll har sin aktiverade egenskap inställd på falseinaktiveras även alla dess inneslutna kontroller. Om användaren till exempel klickar på någon av kontrollerna i en inaktiverad GroupBox kontroll genereras inga händelser.

Se även

• ScrollableControl