当前位置：首页 > news >正文

WinForm常用组件

news 2026/5/13 1:58:58

WinForm常用组件

一、核心交互组件

1、Button（按钮）

触发操作的入口

核心属性

Text：按钮文字
Name：控件的名称
Enabled：是否可点击
BackColor：背景颜色

主要事件

Click：用户点击按钮时触发

2、TextBox（输入框）

用户输入数据

核心属性

Text：输入内容
PasswordChar：密码模式
Multiline：多行
ReadOnly：只读
Font：文本字体
ForeColor/ BackColor：文本和背景颜色

主要事件

TextChanged：当文本框中的文本改变时触发
KeyDown/KeyPress/KeyUp：键盘事件
Enter/Leave：当控件获得或失去焦点时触发

3、Label（标签）

展示信息

核心属性

Text：设置或获取标签显示的文本
AutoSize：是否自动调整大小以适应内容
ForeColor：文本颜色
BorderStyle：边框样式

主要事件

基本不用（偶尔 Click）

二、选择类组件

4、ComboBox（下拉框）

单选 + 可输入

核心属性

Items：字符串的集合，通过 Items.Add() 方法添加项
SelectedItem：当前选中的项（对象类型）
SelectedIndex：当前选中项的索引（从 0 开始，-1 表示未选择）
SelectedValue：获取绑定对象的值
DataSource：List<对象>集合
- DisplayMember：设置显示属性
- ValueMember：绑定值，只有通过ValueMember绑定，SelectedValue才能获取

主要事件

SelectedIndexChanged：当选中项改变时触发

5、RadioButton（单选按钮）

同一个容器内，互斥选择

核心属性

Checked：获取或设置按钮是否被选中
Text：设置按钮显示的文本内容
Appearance：控制显示样式
- Normal：标准单选按钮
- Button：类似按钮的样式

主要事件

CheckedChanged：选中状态变化时触发
Click：设置Appearance值为Button时使用

6、CheckBox（复选框）

多选

核心属性

Checked：设置默认被选中
CheckState：三态模式下的状态(选中、未选中、不确定)

主要事件

同Checked

三、列表类组件

7、ListBox（列表）

展示列表 + 单/多选

核心属性

Items：ListBox 的项目集合（通过 Items.Add() 方法添加项）
SelectedItem：当前选中的项（对象类型）
SelectedIndex：当前选中项的索引（从 0 开始，-1 表示未选择），可设置默认显示
DataSource：List<对象>集合
- DisplayMember：设置显示属性
- ValueMember：绑定值，只有通过ValueMember绑定，SelectedValue才能获取

主要事件

SelectedIndexChanged：当选中项改变时触发
SelectedValueChanged：当 SelectedValue 属性改变时触发

8、CheckedListBox（复选框列表）

带勾选的列表

核心属性

Items：获取CheckedListBox项目集合
CheckOnClick：控制单击行为，true时单击项直接切换选中状态；false时需双击切换（默认行为）

注意： 也可使用ListBox的属性

主要事件

ItemCheck：勾选状态变化时触发，可通过e.NewValue获取新状态

可通过checkedListBox1.Items的Add()、Insert()、Remove()、RemoveAt()方法进行添加插入删除

四、显示类组件

9、PictureBox（图片）

显示图片 / 动画

核心属性

Image：设置或获取显示的图像对象
SizeMode：控制图像显示模式
- Normal：原始大小（可能超出控件范围）
- StretchImage：拉伸填充控件
- AutoSize：控件自动调整为图像大小
- CenterImage：居中显示（不缩放）
- Zoom：等比例缩放以适应控件

保存和加载图片

private void LoadImageFromFile()
{OpenFileDialog openFileDialog = new OpenFileDialog{Filter = "图像文件|*.jpg;*.jpeg;*.png;*.bmp;*.gif"};if (openFileDialog.ShowDialog() == DialogResult.OK){try{pictureBox1.Image = Image.FromFile(openFileDialog.FileName);// 保存路径到设置 LastImagePath 手动创建Properties.Settings.Default.LastImagePath = openFileDialog.FileName;Properties.Settings.Default.Save();}catch (Exception ex){MessageBox.Show($"加载失败: {ex.Message}");}}
}
// 加载窗体时设置图片
private void Form3_Load(object sender, EventArgs e)
{if (!string.IsNullOrEmpty(Properties.Settings.Default.LastImagePath)){try{if (File.Exists(Properties.Settings.Default.LastImagePath)){pictureBox1.Image = Image.FromFile(Properties.Settings.Default.LastImagePath);}}catch (Exception ex){MessageBox.Show($"加载上次图片失败: {ex.Message}");}}
}

10、LinkLabel（超链接）

跳转 / 打开网页

核心属性

Text：设置显示的链接文本
LinkBehavior：链接行为控制
Links：管理链接区域的核心集合（可定义多个链接区域）
LinkColor/ActiveLinkColor/VisitedLinkColor：控制链接的不同状态颜色

主要事件

LinkClicked：用户点击链接时触发

使用示例：

private void CreateLinkLabels(){// 设置文本linkLabel1.Text = "访问 微软 或 百度 或 联系我们";// 添加第一个链接（"微软"）linkLabel1.Links.Add(3, 2, "https://www.microsoft.com");// 添加第二个链接（"谷歌"）linkLabel1.Links.Add(8, 2, "https://www.baidu.com");// 添加第三个链接（"联系我们"）linkLabel1.Links.Add(12, 4, "mailto:support@example.com");// 设置链接颜色linkLabel1.LinkColor = Color.Blue;linkLabel1.VisitedLinkColor = Color.Purple;}private void linkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e){// 示例：显示链接信息MessageBox.Show($"点击了链接: {e.Link.LinkData}", "提示");string protocol = e.Link.LinkData.ToString().Split(':')[0];switch (protocol){case "mailto":// 调用邮件客户端Process.Start($"mailto:{e.Link.LinkData.ToString().Substring(7)}");break;case "tel":// 调用拨号程序Process.Start($"tel:{e.Link.LinkData.ToString().Substring(4)}");break;default:// 默认网页打开Process.Start(new ProcessStartInfo(e.Link.LinkData.ToString()) { UseShellExecute = true });break;}e.Link.Visited = true;}