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.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer mit dem Steuerelement interagieren kann.
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. "Graublenden"-Text in Beschriftungen.
Wenn IsEnabled geändert wird, wird das IsEnabledChanged-Ereignis ausgelöst. Steuerelemente behandeln dieses Ereignis möglicherweise, 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 ihre eigenen Flags verwenden zu müssen.
Ein Steuerelement erbt die IsEnabled-Eigenschaft vom übergeordneten Steuerelement. Wenn beispielsweise ein Steuerelement, das eine Schaltfläche enthält, 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 geerbten Werts ändert.
Wie sich die Steuerelementlogik verhält, wenn deaktiviert ist, unterscheidet sich potenziell für jedes Steuerelement. Diese Verhaltensweisen führen jedoch zu allen Steuerelementen, wenn IsEnabled =false:
- Das Steuerelement kann den Tastaturfokus nicht empfangen oder programmgesteuert fokussiert sein.
- Das Steuerelement wird nicht in einer Registerkartensequenz angezeigt (ein beliebiger Wert für UIElement.TabIndex wird ignoriert).
- Ein deaktiviertes Steuerelement ist weiterhin für Treffertests sichtbar. Es kann keine Eingabeereignisse für sich selbst behandeln. Ein deaktiviertes Steuerelement kann jedoch weiterhin die Eingabeereignisse beziehen, und Weitergeleitete Eingabeereignisse können an ein übergeordnetes Element übergeben werden, in dem sie behandelt werden können.