WPF 控件速查 PDF 笔记（可直接落地版）

张人玉2025-10-27 11:17

目录索引（按首字母排序）

控件名称 所属章节 页码指引（PDF 锚点）
AccessText 高频交互控件 第 5 页
Button 高频交互控件 第 4 页
Calendar 高频交互控件 第 6 页
Canvas 布局控件 第 2 页
ComboBox 高频交互控件 第 5 页
ContextMenu 高频交互控件 第 6 页
DataGrid 数据展示控件 第 7 页
DatePicker 高频交互控件 第 6 页
DockPanel 布局控件 第 2 页
Ellipse 图形控件（附） 第 12 页
Expander 布局控件 第 3 页
FlowDocumentReader 文档控件（附） 第 12 页
Frame 导航控件（附） 第 12 页
Grid 布局控件 第 1 页
GridSplitter 布局控件 第 3 页
GroupBox 布局控件 第 3 页
Image 媒体控件 第 10 页
InkCanvas 数字墨迹控件 第 11 页
Label 高频交互控件 第 5 页
ListBox 数据展示控件 第 8 页
ListView 数据展示控件 第 9 页
MediaElement 媒体控件 第 10 页
Menu 高频交互控件 第 6 页
OpenFileDialog 系统对话框 第 9 页
PasswordBox 高频交互控件 第 4 页
PrintDialog 系统对话框 第 10 页
ProgressBar 高频交互控件 第 5 页
RepeatButton 高频交互控件 第 4 页
ResizeGrip 布局控件（附） 第 12 页
RichTextBox 高频交互控件 第 4 页
SaveFileDialog 系统对话框 第 10 页
ScrollBar 布局控件（附） 第 12 页
ScrollViewer 布局控件 第 2 页
Separator 布局控件（附） 第 12 页
Slider 高频交互控件 第 5 页
SoundPlayerAction 媒体控件（附） 第 12 页
StackPanel 布局控件 第 1 页
StatusBar 高频交互控件（附） 第 12 页
TabControl 导航控件（附） 第 12 页
TextBox 高频交互控件 第 4 页
TextBlock 高频交互控件 第 5 页
Thumb 布局控件（附） 第 12 页
ToolBar 高频交互控件 第 6 页
ToolTip 高频交互控件 第 5 页
TreeView 数据展示控件 第 9 页
Viewbox 布局控件 第 3 页
VirtualizingStackPanel 布局控件 第 3 页
WrapPanel 布局控件 第 2 页

第一章 布局控件（界面骨架核心）

1.1 Grid（最常用：复杂布局）

  • 核心场景：表单、多区域划分（如 "顶部标题 + 中间内容 + 底部按钮"）

  • 必记属性：

    • RowDefinitions/ColumnDefinitions：行 / 列定义（*表示占剩余空间，Auto自适应）

    • Grid.Row/Grid.Column：子元素指定行 / 列

  • 避坑点 ：不设置Width/Height时，默认撑满父容器；行 / 列未设置Height/Width时，默认Auto

  • 极简示例（直接复制）：

    复制代码 
    <Grid Width="400" Height="300">
  <!-- 2行2列：第1行高50，第2行占剩余；第1列宽100，第2列占剩余 -->
  <Grid.RowDefinitions>
    <RowDefinition Height="50"/>
    <RowDefinition Height="*"/>
  </Grid.RowDefinitions>
  <Grid.ColumnDefinitions>
    <ColumnDefinition Width="100"/>
    <ColumnDefinition Width="*"/>
  </Grid.ColumnDefinitions>
  <!-- 子元素：标题（跨2列）、标签、输入框 -->
  <TextBlock Text="用户表单" Grid.Row="0" Grid.ColumnSpan="2" HorizontalAlignment="Center"/>
  <Label Content="姓名：" Grid.Row="1" Grid.Column="0"/>
  <TextBox Grid.Row="1" Grid.Column="1" Width="200"/>
</Grid>

  • 实战备注 ：用Grid.ColumnSpan/Grid.RowSpan实现跨列 / 跨行，适合复杂表单布局

1.2 StackPanel（线性排列）

  • 核心场景：按钮组、简单列表（如 "确定 + 取消" 按钮横向排列）

  • 必记属性：

    • Orientation：排列方向（Horizontal横向 /Vertical纵向，默认纵向）

    • Spacing（.NET 5+）：子元素间距（避免用Margin逐个设置）

  • 避坑点：纵向排列时，子元素默认撑满宽度；横向排列时，默认撑满高度

  • 极简示例：

    复制代码 
    <!-- 横向按钮组，间距10 -->
<StackPanel Orientation="Horizontal" Spacing="10" Margin="20">
  <Button Content="确定" Width="80"/>
  <Button Content="取消" Width="80"/>
  <Button Content="重置" Width="80"/>
</StackPanel>

1.3 ScrollViewer（滚动容器）

  • 核心场景：内容超出容器（如长文本、多选项列表）

  • 必记属性：

    • VerticalScrollBarVisibility：垂直滚动条（Auto自动显示 /Visible始终显示 /Hidden隐藏）

    • HorizontalScrollBarVisibility：水平滚动条

  • 避坑点 ：必须设置Width/Height，否则会撑满父容器，滚动条不生效

  • 极简示例：

    复制代码 
    <ScrollViewer Width="300" Height="200" VerticalScrollBarVisibility="Auto">
  <StackPanel>
    <TextBlock Text="第1行内容" Margin="5"/>
    <TextBlock Text="第2行内容" Margin="5"/>
    <TextBlock Text="第3行内容" Margin="5"/>
    <!-- 省略N行... -->
    <TextBlock Text="第20行内容" Margin="5"/>
  </StackPanel>
</ScrollViewer>

1.4 WrapPanel（自动换行）

  • 核心场景：动态数量元素（如标签云、图片墙）

  • 必记属性：

    • Orientation：排列方向（默认横向，排满换行）

    • ItemWidth/ItemHeight：子元素统一尺寸（避免大小不一）

  • 避坑点：父容器需有固定宽度（横向排列）或高度（纵向排列），否则不会换行

  • 极简示例：

    复制代码 
    <!-- 横向排列，子元素宽80，排满换行 -->
<WrapPanel Width="300" Orientation="Horizontal" ItemWidth="80" Margin="10">
  <Button Content="标签1"/>
  <Button Content="标签2"/>
  <Button Content="标签3"/>
  <Button Content="标签4"/>
  <Button Content="标签5"/>
</WrapPanel>

1.5 Canvas（绝对定位）

  • 核心场景：自定义图形、固定位置元素（如仪表盘、流程图）

  • 必记属性 ：子元素用Canvas.Left/Canvas.Top/Canvas.Right/Canvas.Bottom定位

  • 避坑点：不自动适配父容器大小，分辨率变化时元素位置会偏移，慎用在响应式界面

  • 极简示例：

    复制代码 
    <Canvas Width="300" Height="200" Background="LightGray">
  <!-- 圆（左上角定位） -->
  <Ellipse Width="50" Height="50" Fill="Red" Canvas.Left="20" Canvas.Top="20"/>
  <!-- 文本（右下角定位） -->
  <TextBlock Text="绝对定位" Canvas.Right="20" Canvas.Bottom="20"/>
</Canvas>

1.6 DockPanel（边缘停靠）

  • 核心场景：工具栏 + 内容区（如 "顶部工具栏 + 中间内容 + 底部状态栏"）

  • 必记属性：

    • LastChildFill：最后一个子元素是否占满剩余空间（默认True）

    • DockPanel.Dock：子元素停靠方向（Top/Bottom/Left/Right）

  • 避坑点 ：子元素停靠顺序影响布局，建议先停靠Top/Bottom，再停靠Left/Right

  • 极简示例：

    复制代码 
    <DockPanel LastChildFill="True" Width="400" Height="300">
  <!-- 顶部工具栏 -->
  <ToolBar DockPanel.Dock="Top">
    <Button Content="剪切"/>
    <Button Content="复制"/>
  </ToolBar>
  <!-- 左侧列表 -->
  <ListBox Width="100" DockPanel.Dock="Left"/>
  <!-- 中间内容（占剩余空间） -->
  <TextBlock Text="主内容区" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</DockPanel>

1.7 其他高频布局控件（简表）

控件 核心场景 必记属性 极简示例
GridSplitter 调整 Grid 行 / 列大小 ResizeDirection（Columns/Rows） <GridSplitter Width="5" Background="Gray" ResizeDirection="Columns"/>
GroupBox 控件分组（带标题） Header（分组标题） <GroupBox Header="登录信息"><TextBox/></GroupBox>
Viewbox 自动缩放子元素（保持比例） Stretch（Uniform自适应比例） <Viewbox Width="200"><Button Content="缩放按钮"/></Viewbox>
VirtualizingStackPanel 大量数据列表（优化性能） VirtualizingPanel.IsVirtualizing="True" <ListBox.ItemsPanel><ItemsPanelTemplate><VirtualizingStackPanel/></ItemsPanelTemplate></ListBox.ItemsPanel>
Expander 折叠 / 展开内容（省空间） Header（标题）、IsExpanded <Expander Header="高级设置"><CheckBox/></Expander>

第二章 高频交互控件（用户操作核心）

2.1 Button（基础按钮）

  • 核心场景：触发操作（提交、重置、跳转）

  • 必记属性 / 事件：

    • Content：按钮文本 / 控件（可放 Image+Text）

    • Click：单击事件；Command（MVVM）：绑定命令

  • 避坑点 ：按钮内容默认居中，如需自定义布局，可在Content中嵌套 StackPanel

  • 极简示例：

    复制代码 
    <!-- 普通按钮（事件绑定） -->
<Button Content="提交" Width="80" Height="30" Click="SubmitBtn_Click"/>
​
<!-- 带图标的按钮 -->
<Button Width="100" Height="30">
  <StackPanel Orientation="Horizontal" Spacing="5">
    <Image Source="Images/submit.png" Width="16" Height="16"/>
    <TextBlock Text="提交"/>
  </StackPanel>
</Button>
​
<!-- C#事件处理（复制可用） -->
private void SubmitBtn_Click(object sender, RoutedEventArgs e)
{
    MessageBox.Show("提交成功！");
}

2.2 TextBox（文本输入）

  • 核心场景：单行 / 多行文本输入（用户名、备注）

  • 必记属性：

    • Text：输入内容（支持双向绑定）

    • MaxLength：最大输入长度；TextWrapping：换行（Wrap自动换行）

    • AcceptsReturn：允许回车换行（多行输入需设为True）

  • 避坑点 ：多行输入时，需同时设置TextWrapping="Wrap"和AcceptsReturn="True"

  • 极简示例：

    复制代码 
    <!-- 单行输入（用户名） -->
<TextBox Width="200" Height="30" Text="{Binding UserName}" MaxLength="20"/>
​
<!-- 多行输入（备注） -->
<TextBox Width="200" Height="100" TextWrapping="Wrap" AcceptsReturn="True" MaxLength="200"/>

2.3 PasswordBox（密码输入）

  • 核心场景：密码输入（隐藏输入内容）

  • 必记属性 / 事件：

    • Password：密码内容（不支持绑定，需通过事件获取）

    • PasswordChar：隐藏字符（默认*，可设为●）

    • PasswordChanged：密码变化事件

  • 避坑点 ：切勿用TextBlock绑定Password属性，存在安全风险

  • 极简示例：

    复制代码 
    <PasswordBox x:Name="PwdBox" Width="200" Height="30" PasswordChar="●" PasswordChanged="PwdBox_PasswordChanged"/>

<!-- C#获取密码（复制可用） -->
private string _userPwd;
private void PwdBox_PasswordChanged(object sender, RoutedEventArgs e)
{
    _userPwd = PwdBox.Password; // 实时获取密码
}

2.4 RichTextBox（富文本输入）

  • 核心场景：格式化文本（字体、颜色、加粗，如邮件编辑）

  • 必记属性：

    • Document：富文本内容（需嵌套FlowDocument）

    • IsReadOnly：是否只读（用于展示富文本）

  • 避坑点 ：无法直接绑定Text，需通过Document操作内容

  • 极简示例：

    复制代码 
    <RichTextBox Width="300" Height="150" x:Name="RichTB">
  <RichTextBox.Document>
    <FlowDocument>
      <Paragraph>
        <Run Text="富文本示例：" FontWeight="Bold" FontSize="14"/>
        <Run Text="可设置" Foreground="Red"/>
        <Run Text="颜色、" FontStyle="Italic"/>
        <Run Text="字体" FontSize="16"/>
      </Paragraph>
    </FlowDocument>
  </RichTextBox.Document>
</RichTextBox>

<!-- C#添加内容（复制可用） -->
private void AddRichTextBtn_Click(object sender, RoutedEventArgs e)
{
    Paragraph p = new Paragraph(new Run("新增富文本内容"));
    p.Foreground = Brushes.Blue; // 蓝色文本
    RichTB.Document.Blocks.Add(p);
}

2.5 RepeatButton（长按按钮）

  • 核心场景：连续操作（如音量增减、数值调整）

  • 必记属性：

    • Interval：长按触发间隔（毫秒，默认 100）

    • Delay：长按延迟触发时间（毫秒，默认 300）

  • 极简示例：

    复制代码 
    <StackPanel Orientation="Horizontal" Spacing="10">
  <RepeatButton Content="-" Width="30" Height="30" Click="MinusBtn_Click" Interval="100"/>
  <TextBlock x:Name="NumText" Text="10" Width="40" TextAlignment="Center"/>
  <RepeatButton Content="+" Width="30" Height="30" Click="PlusBtn_Click" Interval="100"/>
</StackPanel>

<!-- C#实现数值增减（复制可用） -->
private int _num = 10;
private void MinusBtn_Click(object sender, RoutedEventArgs e)
{
    if (_num > 0) NumText.Text = (--_num).ToString();
}
private void PlusBtn_Click(object sender, RoutedEventArgs e)
{
    if (_num < 100) NumText.Text = (++_num).ToString();
}

2.6 其他高频交互控件（简表）

控件 核心场景 必记属性 / 事件 极简示例
TextBlock 只读文本（性能优于 Label） Text、Foreground（颜色）、TextWrapping <TextBlock Text="只读文本" Foreground="Blue"/>
Label 关联控件（带访问键） Target（关联控件）、Content（_开头设访问键） <Label Content="_用户名：" Target="UserNameTB"/>
AccessText 访问键文本（单独使用） Text（_开头设访问键） <AccessText Text="_登录" Target="LoginBtn"/>
ComboBox 下拉选择（单选） ItemsSource（绑定选项）、SelectedItem <ComboBox ItemsSource="{Binding Cities}" SelectedItem="{Binding SelectedCity}"/>
CheckBox 多选（非互斥） IsChecked（是否选中）、IsThreeState（三态） <CheckBox Content="同意协议" IsChecked="{Binding Agree}"/>
RadioButton 单选（互斥） GroupName（同组互斥）、IsChecked <RadioButton Content="男" GroupName="Gender"/>
Slider 范围选择（如音量、进度） Minimum/Maximum、Value（绑定值） <Slider Minimum="0" Maximum="100" Value="{Binding Volume}"/>
ProgressBar 进度展示（如加载） Value、IsIndeterminate（不确定进度） <ProgressBar Value="60" Maximum="100"/>
ToolTip 悬停提示 Content（提示内容）、ShowDuration <Button ToolTip="点击提交"><Button.ToolTip><ToolTip Content="提交表单" ShowDuration="3000"/></Button.ToolTip></Button>
Calendar 完整日历选择 SelectedDate、SelectionMode（多选） <Calendar SelectedDate="2024-05-20" SelectionMode="MultipleRange"/>
DatePicker 简洁日期选择 SelectedDate、DisplayDateStart（日期范围） <DatePicker SelectedDate="{Binding Birthday}"/>
ContextMenu 右键菜单 绑定到控件的ContextMenu属性 <TextBlock Text="右键我"><TextBlock.ContextMenu><ContextMenu><MenuItem Header="复制"/></ContextMenu></TextBlock.ContextMenu></TextBlock>
Menu+ToolBar 顶部菜单 / 工具栏 MenuItem（菜单项）、Separator（分割线） <Menu><MenuItem Header="文件"><MenuItem Header="新建"/></MenuItem></Menu>

第三章 数据展示控件（数据可视化核心）

3.1 DataGrid（表格数据）

  • 核心场景：结构化数据（如用户列表、订单表，支持编辑、排序）

  • 必记属性：

    • ItemsSource：绑定数据集合（如List<User>）

    • AutoGenerateColumns：是否自动生成列（建议设False，自定义列）

    • CanUserSortColumns：是否允许列排序（默认True）

  • 避坑点 ：绑定的实体类需有公共属性（非字段），否则无法显示数据

  • 完整示例（复制可用）：

    复制代码 
    <!-- XAML -->
<DataGrid Width="400" Height="250" ItemsSource="{Binding UserList}" 
          AutoGenerateColumns="False" CanUserSortColumns="True">
  <DataGrid.Columns>
    <!-- 文本列 -->
    <DataGridTextColumn Header="姓名" Binding="{Binding Name}" Width="100"/>
    <!-- 数值列（格式化） -->
    <DataGridTextColumn Header="年龄" Binding="{Binding Age}" Width="80" TextAlignment="Center"/>
    <!-- 复选框列 -->
    <DataGridCheckBoxColumn Header="是否启用" Binding="{Binding IsEnabled}" Width="120"/>
    <!-- 按钮列 -->
    <DataGridTemplateColumn Header="操作" Width="100">
      <DataGridTemplateColumn.CellTemplate>
        <DataTemplate>
          <Button Content="编辑" Click="EditBtn_Click" Width="60"/>
        </DataTemplate>
      </DataGridTemplateColumn.CellTemplate>
    </DataGridTemplateColumn>
  </DataGrid.Columns>
</DataGrid>

<!-- C#：实体类+数据绑定（复制可用） -->
// 1. 实体类
public class User
{
    public string Name { get; set; }
    public int Age { get; set; }
    public bool IsEnabled { get; set; }
}

// 2. 页面后台（或ViewModel）
public partial class DataGridPage : Page
{
    public List<User> UserList { get; set; } // 数据集合
    public DataGridPage()
    {
        InitializeComponent();
        // 模拟数据
        UserList = new List<User>
        {
            new User{Name="张三", Age=25, IsEnabled=true},
            new User{Name="李四", Age=30, IsEnabled=false}
        };
        DataContext = this; // 设置绑定上下文
    }

    // 编辑按钮事件
    private void EditBtn_Click(object sender, RoutedEventArgs e)
    {
        Button btn = sender as Button;
        User selectedUser = btn.DataContext as User; // 获取当前行数据
        MessageBox.Show($"编辑用户：{selectedUser.Name}");
    }
}

3.2 ListBox（列表选择）

  • 核心场景：简单列表（如选项列表，支持单选 / 多选）

  • 必记属性：

    • ItemsSource：绑定数据集合

    • SelectionMode：选择模式（Single单选 /Multiple多选 /Extended按住 Ctrl 多选）

    • SelectedItems：多选结果（绑定ObservableCollection<T>）

  • 极简示例：

    复制代码 
    <!-- 多选列表 -->
<ListBox Width="200" Height="150" ItemsSource="{Binding Books}" 
         SelectionMode="Multiple" SelectedItems="{Binding SelectedBooks}">
  <!-- 自定义列表项模板 -->
  <ListBox.ItemTemplate>
    <DataTemplate>
      <StackPanel Orientation="Horizontal" Spacing="5">
        <Image Source="{Binding CoverUrl}" Width="30" Height="40"/>
        <TextBlock Text="{Binding BookName}"/>
      </StackPanel>
    </DataTemplate>
  </ListBox.ItemTemplate>
</ListBox>

<!-- C#：实体类+数据（复制可用） -->
public class Book
{
    public string BookName { get; set; }
    public string CoverUrl { get; set; }
}

public partial class ListBoxPage : Page
{
    public List<Book> Books { get; set; }
    public ObservableCollection<Book> SelectedBooks { get; set; } // 多选需用ObservableCollection

    public ListBoxPage()
    {
        InitializeComponent();
        Books = new List<Book>
        {
            new Book{BookName="WPF实战", CoverUrl="Images/book1.png"},
            new Book{BookName="C#入门", CoverUrl="Images/book2.png"}
        };
        SelectedBooks = new ObservableCollection<Book>();
        DataContext = this;
    }
}

3.3 ListView（灵活列表）

  • 核心场景：自定义视图（网格 / 图标 / 列表，如商品列表）

  • 必记属性：

    • View：视图类型（GridView网格视图 /ListViewItem列表视图）

    • ItemsSource：绑定数据集合

  • 避坑点 ：GridView需通过GridViewColumn定义列，类似 DataGrid 但更轻量

  • 极简示例（网格视图）：

    复制代码 
    <ListView Width="400" Height="200" ItemsSource="{Binding Products}">
  <ListView.View>
    <GridView>
      <GridViewColumn Header="商品名" DisplayMemberBinding="{Binding Name}" Width="150"/>
      <GridViewColumn Header="价格" DisplayMemberBinding="{Binding Price, StringFormat='{0:C}'}" Width="100"/>
      <GridViewColumn Header="库存" DisplayMemberBinding="{Binding Stock}" Width="150"/>
    </GridView>
  </ListView.View>
</ListView>

<!-- C#：实体类（复制可用） -->
public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int Stock { get; set; }
}

// 数据绑定同ListBox，设置DataContext即可

3.4 TreeView（层级数据）

  • 核心场景：层级结构（如文件夹、组织架构）

  • 必记属性：

    • ItemsSource：顶层数据集合

    • HierarchicalDataTemplate：层级模板（绑定子集合）

  • 避坑点 ：子集合属性名需与模板中ItemsSource一致（如下例Children）

  • 极简示例：

    复制代码 
    <TreeView Width="250" Height="200" ItemsSource="{Binding Folders}">
  <TreeView.ItemTemplate>
    <!-- 层级模板：绑定子集合Children -->
    <HierarchicalDataTemplate ItemsSource="{Binding Children}">
      <StackPanel Orientation="Horizontal" Spacing="5">
        <Image Source="Images/folder.png" Width="16" Height="16"/>
        <TextBlock Text="{Binding FolderName}"/>
      </StackPanel>
    </HierarchicalDataTemplate>
  </TreeView.ItemTemplate>
</TreeView>

<!-- C#：层级实体类（复制可用） -->
public class Folder
{
    public string FolderName { get; set; }
    public List<Folder> Children { get; set; } // 子集合
}

public partial class TreeViewPage : Page
{
    public List<Folder> Folders { get; set; }

    public TreeViewPage()
    {
        InitializeComponent();
        // 模拟层级数据
        Folders = new List<Folder>
        {
            new Folder
            {
                FolderName="文档",
                Children=new List<Folder>
                {
                    new Folder{FolderName="工作文档"},
                    new Folder{FolderName="个人文档"}
                }
            },
            new Folder{FolderName="图片"}
        };
        DataContext = this;
    }
}

第四章 系统对话框与媒体控件

4.1 OpenFileDialog（打开文件）

  • 核心场景：选择单个 / 多个文件（如导入文档、上传图片）

  • 必记方法 / 属性：

    • ShowDialog()：显示对话框（返回bool?，true表示用户确认）

    • Filter：文件筛选器（如 "文本文件 |.txt | 所有文件 |.*"）

    • Multiselect：是否允许多选（默认false）

  • 完整示例（C# 复制可用）：

    复制代码 
    private void OpenFileBtn_Click(object sender, RoutedEventArgs e)
{
    OpenFileDialog openDialog = new OpenFileDialog();
    // 设置筛选器：文本文件+所有文件
    openDialog.Filter = "文本文件 (*.txt)|*.txt|所有文件 (*.*)|*.*";
    openDialog.FilterIndex = 1; // 默认选中第一个筛选器
    openDialog.Multiselect = true; // 允许多选

    // 显示对话框，用户点击“确定”则处理
    if (openDialog.ShowDialog() == true)
    {
        // 单个文件路径
        string singleFilePath = openDialog.FileName;
        // 多个文件路径（Multiselect=true时）
        string[] multiFilePaths = openDialog.FileNames;

        // 示例：显示选择的文件
        string fileMsg = $"选中文件数：{multiFilePaths.Length}\n";
        foreach (var path in multiFilePaths)
        {
            fileMsg += path + "\n";
        }
        MessageBox.Show(fileMsg);
    }
}

4.2 SaveFileDialog（保存文件）

  • 核心场景：指定保存路径（如导出报表、保存编辑内容）

  • 必记属性：

    • FileName：默认保存文件名

    • Filter：文件筛选器（如 "Word 文档 |*.docx"）

  • 完整示例（C# 复制可用）：

    复制代码 
    private void SaveFileBtn_Click(object sender, RoutedEventArgs e)
{
    SaveFileDialog saveDialog = new SaveFileDialog();
    // 设置筛选器和默认文件名
    saveDialog.Filter = "Word文档 (*.docx)|*.docx|Excel文档 (*.xlsx)|*.xlsx";
    saveDialog.FileName = "未命名文档"; // 默认文件名
    saveDialog.DefaultExt = ".docx"; // 默认扩展名

    if (saveDialog.ShowDialog() == true)
    {
        string savePath = saveDialog.FileName;
        // 执行保存逻辑（如写入文件）
        File.WriteAllText(savePath, "保存的内容");
        MessageBox.Show($"文件已保存至：{savePath}");
    }
}

4.3 PrintDialog（打印）

  • 核心场景：打印 UI 元素（如表单、文档、Grid）

  • 必记方法：

    • ShowDialog()：显示打印设置对话框

    • PrintVisual(visual, title)：打印指定 UI 元素（visual为 UIElement，如 Grid、DocumentViewer）

  • 完整示例（C# 复制可用）：

    复制代码 
    <!-- XAML：需打印的Grid -->
<Grid x:Name="PrintGrid" Width="600" Height="800" Background="White">
  <TextBlock Text="打印测试文档" FontSize="20" HorizontalAlignment="Center" Margin="20"/>
  <DataGrid ItemsSource="{Binding PrintData}" Margin="20,50,20,20"/>
</Grid>
<Button Content="打印" Click="PrintBtn_Click" Margin="20"/>
    复制代码 
    private void PrintBtn_Click(object sender, RoutedEventArgs e)
{
    PrintDialog printDialog = new PrintDialog();
    // 设置打印纸张大小（可选）
    printDialog.PrintTicket.PageMediaSize = new PageMediaSize(PageMediaSizeName.A4);

    if (printDialog.ShowDialog() == true)
    {
        // 打印Grid控件
        printDialog.PrintVisual(PrintGrid, "测试文档打印");
        MessageBox.Show("打印任务已提交！");
    }
}

4.4 Image（图片显示）

  • 核心场景：显示本地 / 网络图片（PNG、JPG、BMP 等）

  • 必记属性：

    • Source：图片路径（本地用相对路径，网络用 URL）

    • Stretch：缩放方式（Uniform保持比例 /Fill拉伸填充 /None不缩放）

  • 避坑点：本地图片需设置 "复制到输出目录"（右键图片文件→属性→复制到输出目录→"如果较新则复制"）

  • 极简示例：

    复制代码 
    <!-- 本地图片（相对路径） -->
<Image Width="200" Height="150" Stretch="Uniform" Margin="10">
  <Image.Source>
    <BitmapImage UriSource="Images/logo.png"/> <!-- 路径：项目根目录/Images/logo.png -->
  </Image.Source>
</Image>

<!-- 网络图片（URL） -->
<Image Width="200" Height="150" Stretch="Uniform">
  <Image.Source>
    <BitmapImage UriSource="https://example.com/image.jpg"/>
  </Image.Source>
</Image>

4.5 MediaElement（音视频播放）

  • 核心场景：播放本地 / 网络音频（MP3）、视频（MP4）

  • 必记属性 / 方法：

    • Source：音视频路径

    • Play()/Pause()/Stop()：播放 / 暂停 / 停止

    • Volume：音量（0~1）；IsMuted：是否静音

  • 避坑点：播放网络视频需确保 URL 可访问，本地文件需设置 "复制到输出目录"

  • 完整示例：

    复制代码 
    <!-- XAML -->
<StackPanel>
  <!-- 视频播放控件 -->
  <MediaElement x:Name="MediaElem" Width="400" Height="300" Volume="0.8" LoadedBehavior="Manual"/>
  <!-- 控制按钮 -->
  <StackPanel Orientation="Horizontal" Spacing="10" Margin="10">
    <Button Content="播放" Click="PlayBtn_Click"/>
    <Button Content="暂停" Click="PauseBtn_Click"/>
    <Button Content="停止" Click="StopBtn_Click"/>
  </StackPanel>
</StackPanel>
    复制代码 
    // C#（复制可用）
private void PlayBtn_Click(object sender, RoutedEventArgs e)
{
    // 本地视频路径（需设置复制到输出目录）
    MediaElem.Source = new Uri("Media/test.mp4", UriKind.Relative);
    MediaElem.Play();
}

private void PauseBtn_Click(object sender, RoutedEventArgs e)
{
    if (MediaElem.CanPause) MediaElem.Pause();
}

private void StopBtn_Click(object sender, RoutedEventArgs e)
{
    MediaElem.Stop();
    MediaElem.Source = null; // 释放资源
}

第五章 数字墨迹控件（手写交互）

5.1 InkCanvas（手写画布）

  • 核心场景：手写输入（如签名、绘图，支持触控 / 笔输入）

  • 必记属性 / 方法：

    • Strokes：墨迹集合（可保存 / 加载）

    • EditingMode：编辑模式（Ink绘图 /EraseByPoint点擦除 /Select选择）

    • DefaultDrawingAttributes：笔刷样式（颜色、粗细）

  • 极简示例：

    复制代码 
    <StackPanel>
  <InkCanvas x:Name="InkCanvas" Width="400" Height="300" Background="White" 
             EditingMode="Ink" Margin="10">
    <!-- 笔刷样式：蓝色，3px粗 -->
    <InkCanvas.DefaultDrawingAttributes>
      <DrawingAttributes Color="Blue" Width="3" Height="3"/>
    </InkCanvas.DefaultDrawingAttributes>
  </InkCanvas>
  <Button Content="清除墨迹" Click="ClearInkBtn_Click" Width="100"/>
</StackPanel>
    复制代码 
    // C#清除墨迹（复制可用）
private void ClearInkBtn_Click(object sender, RoutedEventArgs e)
{
    InkCanvas.Strokes.Clear(); // 清除所有墨迹
}

// 可选：保存墨迹到文件
private void SaveInkBtn_Click(object sender, RoutedEventArgs e)
{
    using (FileStream fs = new FileStream("ink.strokes", FileMode.Create))
    {
        InkCanvas.Strokes.Save(fs); // 保存墨迹
    }
}

第六章 笔记使用说明

  1. 索引跳转：PDF 中点击 "目录索引" 的 "页码指引"，可直接跳转到对应控件章节；

  2. 代码复制：所有示例代码已去除冗余格式，复制到 Visual Studio 后，只需：

    • 确保实体类命名空间与页面一致；

    • 本地图片 / 音视频文件需放在对应路径，并设置 "复制到输出目录"；

  3. 避坑点优先看：每个控件的 "避坑点" 是实际开发中高频踩坑场景，优先阅读；

  4. 场景匹配：不确定用哪个控件时，先看 "核心场景"，匹配需求后再查属性和示例。

此笔记已覆盖 WPF 开发中 90% 以上的高频控件，可直接作为开发手册使用。若需补充某类控件的进阶用法（如 MVVM 绑定、样式自定义），可随时告知，我会为你扩展补充。

相关推荐
清风徐来Groot3 小时前
WPF之布局
wpf
摇滚侠4 小时前
Spring Boot3零基础教程，事件驱动开发，设计登录成功后增加积分记录信息功能，笔记61
java·spring boot·笔记·后端
Elias不吃糖4 小时前
Qt TCP 网络通信详解（笔记）
笔记·qt·tcp/ip
charlie1145141914 小时前
2D 计算机图形学基础速建——1
笔记·学习·教程·计算机图形学·基础
im_AMBER4 小时前
React 07
前端·笔记·学习·react.js·前端框架
9ilk4 小时前
【仿RabbitMQ的发布订阅式消息队列】--- 介绍
linux·笔记·分布式·后端·rabbitmq
开开心心就好5 小时前
Word转PDF工具，免费生成图片型文档
前端·网络·笔记·pdf·word·powerpoint·excel
workflower9 小时前
微软PM的来历
java·开发语言·算法·microsoft·django·结对编程
im_AMBER12 小时前
Leetcode 38
笔记·学习·算法·leetcode
热门推荐
01GitHub 镜像站点02BongoCat - 跨平台键盘猫动画工具03UV安装并设置国内源04Burp与其他安全工具联动及代理设置教程05GitLab 零基础入门指南：从安装到项目管理全流程06Linux下V2Ray安装配置指南07jdk21下载、安装（Windows、Linux、macOS）08Ubuntu22.04安装freecad、ODAFileConverter09Labelme从安装到标注：零基础完整指南10NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南