Control.IsEnabled Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob der Benutzer mit dem Steuerelement interagieren kann, oder legt einen 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
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. "grauen" 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, bei dem sich der Wert aufgrund des erbenden Werts ändert.
Wie sich die Steuerelementlogik verhält, wenn sie deaktiviert wird, ist möglicherweise für jedes Steuerelement unterschiedlich. Dieses Verhalten führt jedoch zu allen Steuerelementen, wenn IsEnabled =false ist:
- Das Steuerelement kann den Tastaturfokus nicht empfangen oder programmgesteuert fokussiert sein.
- Das Steuerelement wird nicht in einer Registerkartensequenz angezeigt (jeder Wert für TabIndex wird ignoriert).
- Ein deaktiviertes Steuerelement ist für Treffertests weiterhin sichtbar. 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 verarbeitet werden können.