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

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

一、TextBox的基础知识

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

TextBox的基本定义

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

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

二、TextBox的常见属性

1. Text

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

2. Width 和 Height

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

3. HorizontalAlignment 和 VerticalAlignment

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

4. MaxLength

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

5. IsReadOnly

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

示例

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

三、TextBox的常见事件

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

1. TextChanged

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

后台代码

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

2. GotFocus 和 LostFocus

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

XAML代码

后台代码

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代码

后台代码

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代码

后台代码

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

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

四、总结

在本篇博客中，我们详细介绍了 WPF 中 TextBox 控件的常见属性和事件。通过这些示例代码，你可以了解如何设置 TextBox 的外观和行为，并且能够处理用户的输入和交互。这些知识对于创建丰富和互动的用户界面至关重要。