Control.IsEnabled Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Ruft einen Wert ab, der angibt, ob der Benutzer mit dem Steuerelement interagieren kann, oder legt den Wert fest.

public:
 property bool IsEnabled { bool get(); void set(bool value); };
bool IsEnabled();

void IsEnabled(bool value);
public bool IsEnabled { get; set; }
var boolean = control.isEnabled;
control.isEnabled = boolean;
Public Property IsEnabled As Boolean
<control IsEnabled="bool"/>

Eigenschaftswert

Boolean

bool

true , wenn der Benutzer mit dem Steuerelement interagieren kann; andernfalls false.

Hinweise

Viele Steuerelemente verfügen über vordefinierte visuelle Zustände, die für IsEnabled =false aufgerufen werden, z. B. "Ausgrauen" von Text in Bezeichnungen.

Bei jeder Änderung von IsEnabled wird das IsEnabledChanged-Ereignis ausgelöst . Steuerelemente können dieses Ereignis behandeln, um die visuellen Zustände zu ändern. Das Ereignis verfügt über DependencyPropertyChangedEventArgs-Daten , sodass Sie die alten und neuen Werte bestimmen können, ohne eigene Flags verwenden zu müssen.

Ein Steuerelement erbt die IsEnabled-Eigenschaft vom übergeordneten Steuerelement. Wenn beispielsweise für ein Steuerelement, das eine Schaltfläche enthält, IsEnabled auf false festgelegt ist, ist die IsEnabled-Eigenschaft der Schaltfläche ebenfalls false. Wenn sich die Eigenschaft des übergeordneten Elements ändert, wird IsEnabledChanged für jedes Steuerelement ausgelöst, in dem sich der Wert aufgrund des Vererbens des Werts ändert.

Wie sich die Steuerelementlogik verhält, wenn sie deaktiviert ist, ist möglicherweise für jedes Steuerelement unterschiedlich. Diese Verhaltensweisen führen jedoch zu allen Steuerelementen, wenn IsEnabled =false ist:

  • Das Steuerelement kann weder den Tastaturfokus empfangen noch programmgesteuert fokussiert werden.
  • Das Steuerelement wird nicht in einer Registerkartensequenz angezeigt (jeder Wert für UIElement.TabIndex wird ignoriert).
  • Ein deaktiviertes Steuerelement ist weiterhin sichtbar, um tests durchzuführen. Es kann keine Eingabeereignisse für sich selbst verarbeiten. Ein deaktiviertes Steuerelement kann jedoch weiterhin die Eingabeereignisse beziehen, und weitergeleitete Eingabeereignisse können an ein übergeordnetes Element weitergeleitet werden, wo sie behandelt werden können.

Gilt für:

Weitere Informationen