Control.Enabled-Eigenschaft

Ruft einen Wert ab, der angibt, ob das Steuerelement auf Benutzerinteraktionen reagieren kann, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property Enabled As Boolean
'Usage
Dim instance As Control
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[LocalizableAttribute(true)] 
public bool Enabled { get; set; }

[LocalizableAttribute(true)] 
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

public function get Enabled () : boolean

public function set Enabled (value : boolean)

Eigenschaftenwert

true, wenn das Steuerelement auf Benutzerinteraktionen reagieren kann, andernfalls false. Der Standardwert ist true.

Hinweise

Mit der Enabled-Eigenschaft können Sie Steuerelemente zur Laufzeit aktivieren oder deaktivieren. Sie können z. B. Steuerelemente deaktivieren, die im aktuellen Zustand der Anwendung nicht verwendet werden sollen. Sie können ein Steuerelement auch deaktivieren, um seine Verwendung einzuschränken. Eine Schaltfläche kann z. B. deaktiviert werden, damit der Benutzer nicht auf sie klicken kann. Wenn ein Steuerelement deaktiviert ist, kann es nicht ausgewählt werden.

Wichtig

Durch Festlegen der Enabled-Eigenschaft auf false wird das Steuerfeld der Anwendung nicht deaktiviert, und es wird nicht verhindert, dass das Anwendungsfenster den Fokus erhält.

Wenn die Enabled-Eigenschaft eines Containersteuerelements auf false festgelegt ist, werden sämtliche darin enthaltenen Steuerelemente ebenfalls deaktiviert. Wenn z. B. auf eines der in einem deaktivierten GroupBox-Steuerelement enthaltenen Steuerelemente geklickt wird, werden keine Ereignisse ausgelöst.

Hinweis

Wenn ein bildlauffähiges Steuerelement deaktiviert wird, werden die Bildlaufleisten ebenfalls deaktiviert. Ein deaktiviertes mehrzeiliges Textfeld kann z. B. nicht gescrollt werden, um alle Textzeilen anzuzeigen.

Beispiel

Im folgenden Codebeispiel wird eine GroupBox erstellt, und einige ihrer allgemeinen Eigenschaften werden festgelegt. Im Beispiel wird eine TextBox erstellt. Außerdem wird ihre Location innerhalb des Gruppenfelds festgelegt. Anschließend wird die Text-Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld oben am Formular angedockt. Abschließend wird das Gruppenfeld durch Festlegen der Enabled-Eigenschaft auf false deaktiviert, wodurch alle im Gruppenfeld enthaltenen Steuerelemente deaktiviert werden.

' 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

// 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:
   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.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
ScrollableControl