C# WPF入门学习主线篇（六）—— TextBox常见属性和事件

欢迎回到C# WPF入门学习系列的第六篇。在前面的文章中，我们探讨了按钮（Button）的事件处理。今天，我们将继续学习另一个常用的WPF控件——TextBox。本文将介绍 TextBox 的常见属性和事件，并通过示例代码展示如何在实际应用中使用这些功能。

一、TextBox的基础知识

TextBox 是WPF中一个重要的输入控件，允许用户在应用程序中输入和编辑文本。它常用于表单、搜索框和任何需要文本输入的场景。

TextBox的基本定义

我们先来看看一个简单的 TextBox 定义：

<Window 
    x:Class="WpfApp.MainWindow" 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
    Title="MainWindow" Height="350" Width="525"> 
<Grid> 
    <TextBox x:Name="myTextBox" Width="200" Height="30" 
        HorizontalAlignment="Center" 
        VerticalAlignment="Center" 
        Text="Hello, World!" /> 
</Grid> 
</Window>

在这个示例中，我们定义了一个 TextBox 控件，其默认文本为“Hello, World!”。

二、TextBox的常见属性

1. Text

Text 属性用于获取或设置 TextBox 中的文本内容。在上面的示例中，Text="Hello, World!" 设置了 TextBox 的初始文本。

2. Width 和 Height

Width 和 Height 属性用于设置 TextBox 的宽度和高度。例如：

<TextBox Width="200" Height="30" />

3. HorizontalAlignment 和 VerticalAlignment

HorizontalAlignment 和 VerticalAlignment 属性用于设置 TextBox 在父容器中的水平和垂直对齐方式。例如：

<TextBox HorizontalAlignment="Center" VerticalAlignment="Center" />

4. MaxLength

MaxLength 属性用于设置 TextBox 中允许输入的最大字符数。例如：

<TextBox MaxLength="100" />

5. IsReadOnly

IsReadOnly 属性用于设置 TextBox 是否为只读。例如：

<TextBox IsReadOnly="True" />

示例

下面是一个包含以上常见属性的完整示例：

<TextBox 
x:Name="myTextBox" Width="200" Height="30" 
HorizontalAlignment="Center" VerticalAlignment="Center" 
Text="Hello, World!" 
MaxLength="100" 
IsReadOnly="False" 
/>

三、TextBox的常见事件

TextBox 支持多种事件，用于处理用户输入和交互。我们来看看一些常见的事件及其用法。

1. TextChanged

TextChanged 事件在 TextBox 的文本内容发生变化时触发。我们可以在后台代码中处理这个事件：

<TextBox 
x:Name="myTextBox" Width="200" Height="30" 
HorizontalAlignment="Center" VerticalAlignment="Center" 
TextChanged="MyTextBox_TextChanged" 
/>

后台代码

private void MyTextBox_TextChanged(object sender, TextChangedEventArgs e) {
 MessageBox.Show($"Text changed: {myTextBox.Text}"); 
}

2. GotFocus 和 LostFocus

GotFocus 事件在 TextBox 获得焦点时触发，LostFocus 事件在 TextBox 失去焦点时触发。

XAML代码

<TextBox 
x:Name="myTextBox" Width="200" Height="30" 
HorizontalAlignment="Center" VerticalAlignment="Center" 
GotFocus="MyTextBox_GotFocus" LostFocus="MyTextBox_LostFocus" 
/>

后台代码

private void MyTextBox_GotFocus(object sender, RoutedEventArgs e) {
 myTextBox.Background = new SolidColorBrush(Colors.LightYellow); 
} 
private void MyTextBox_LostFocus(object sender, RoutedEventArgs e) {
 myTextBox.Background = new SolidColorBrush(Colors.White); 
}

3. KeyDown 和 KeyUp

KeyDown 事件在用户按下键盘键时触发，KeyUp 事件在用户释放键盘键时触发。

XAML代码

<TextBox 
x:Name="myTextBox" Width="200" Height="30" 
HorizontalAlignment="Center" VerticalAlignment="Center" 
KeyDown="MyTextBox_KeyDown" KeyUp="MyTextBox_KeyUp" 
/>

后台代码

private void MyTextBox_KeyDown(object sender, KeyEventArgs e) {
 if (e.Key == Key.Enter) { MessageBox.Show("Enter key pressed!");
 } 
} 

private void MyTextBox_KeyUp(object sender, KeyEventArgs e) {
 // 处理键盘释放事件 
}

4. PreviewTextInput

PreviewTextInput 事件在文本输入之前触发，通常用于自定义输入验证。

XAML代码

<TextBox 
x:Name="myTextBox" Width="200" Height="30" 
HorizontalAlignment="Center" VerticalAlignment="Center" PreviewTextInput="MyTextBox_PreviewTextInput" 
/>

后台代码

private void MyTextBox_PreviewTextInput(object sender, TextCompositionEventArgs e) {
 // 只允许输入数字 e.Handled = !IsTextAllowed(e.Text); 
}

 private static bool IsTextAllowed(string text) {
 return text.All(char.IsDigit); 
}