UIElement.IsEnabled Property
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace: http://schemas.microsoft.com/winfx/2006/xaml/presentation
/** @property */ public final boolean get_IsEnabled () /** @property */ public void set_IsEnabled (boolean value)
public final function get IsEnabled () : boolean public function set IsEnabled (value : boolean)
<object IsEnabled="bool" .../>
Property Value
true if the element is enabled; otherwise, false. The default value is true.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Therefore, the default value listed here is sometimes not effective. For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.
Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.
The following example shows a handler on one button that when executed will set IsEnabled false on another named button b1.
public partial class RoutedEventAddRemoveHandler { void MakeButton(object sender, RoutedEventArgs e) { Button b2 = new Button(); b2.Content = "New Button"; // Associate event handler to the button. You can remove the event // handler using "-=" syntax rather than "+=". b2.Click += new RoutedEventHandler(Onb2Click); root.Children.Insert(root.Children.Count, b2); DockPanel.SetDock(b2, Dock.Top); text1.Text = "Now click the second button..."; b1.IsEnabled = false; } void Onb2Click(object sender, RoutedEventArgs e) { text1.Text = "New Button (b2) Was Clicked!!"; }
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.Reference
UIElement ClassUIElement Members
System.Windows Namespace
IsEnabledChanged