WPF IsEnabled Property (Button Example)

Use the IsEnabled property with the Button control. Set IsEnabled in a C# event handler.

IsEnabled is a bool property. It is available on many controls in WPF, including the TextBox and Button. When IsEnabled is False, a control is made inactive—it cannot be clicked or used. We use it with an expression.BoolControls

Let us begin. First, I added a TextBox and a Button to the Window, which nests the controls within a Grid. On the TextBox, I changed the Text to be empty. On the Button, I set IsEnabled to false.

TextChanged: On the TextBox I added a TextChanged event handler. Press tab after typing TextChanged in the XAML.

Name: On the Button, I added a Name attribute. This makes the Button easy to access in C# code by the identifier "SendButton."


You will need to drag the controls around so that they are positioned in a nice way. The Grid control, which is nested by default in the Window, makes this much easier. Then we add code to the TextBox_TextChanged event handler.Grid

TextChanged: Here we cast the sender object to a TextBox reference with the as-cast. Then, we access the Button by its name (SendButton).


And: IsEnabled is assigned to the result of an expression. The expression evaluates to true when the TextBox has one or more characters.

So: The Button becomes enabled when the TextBox has text. It remains disabled whenever the TextBox is empty.

Example markup: XAML <Window x:Class="WpfApplication12.MainWindow" xmlns="" xmlns:x="" Title="MainWindow" Height="350" Width="525"> <Grid> <TextBox HorizontalAlignment="Left" Height="23" Margin="10,10,0,0" TextWrapping="Wrap" Text="" VerticalAlignment="Top" Width="120" TextChanged="TextBox_TextChanged"/> <Button Content="Send" HorizontalAlignment="Left" Margin="135,10,0,0" VerticalAlignment="Top" Width="75" IsEnabled="False" Name="SendButton"/> </Grid> </Window> Example code: C# using System.Windows; using System.Windows.Controls; namespace WpfApplication12 { public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); } private void TextBox_TextChanged(object sender, TextChangedEventArgs e) { // Cast TextBox. TextBox box = sender as TextBox; // If text is present, enable the button. // ... Otherwise disable the button. this.SendButton.IsEnabled = box.Text.Length > 0; } } }

Expressions. Expressions can be used to make WPF programs better. Please notice how we use an expression to control the value of the IsEnabled property in the example. This means an if-statement is not required.

Instead: The IsEnabled property is tied to an expression. It handles true and false values correctly.


And: The enabled state of the Button will not lose sync with the TextBox. This approach leads to UIs that are reliable.

When creating WPF (or Windows Forms) programs, logic rapidly becomes complex. The simple programs on this website misrepresent reality. Using expressions to maintain state, as with IsEnabled here, keeps things simpler.

Summary. In WPF programs, many concepts are used together. For example, a TextChanged event on a TextBox affects the IsEnabled property of a Button. And a bool property can be set with a C# expression.
Dot Net Perls
© 2007-2020 Sam Allen. Every person is special and unique. Send bug reports to