WPF 概述

项目
05/04/2023

使用 Windows Presentation Foundation (WPF)，你可以创建适用于 Windows 且具有非凡视觉效果的桌面客户端应用程序。

Contoso Healthcare UI sample

WPF 的核心是一个与分辨率无关且基于矢量的呈现引擎，旨在充分利用现代图形硬件。 WPF 通过一套完善的应用程序开发功能对该核心进行了扩展，这些功能包括可扩展应用程序标记语言 (XAML)、控件、数据绑定、布局、二维和三维图形、动画、样式、模板、文档、媒体、文本和版式。 WPF 属于 .NET，因此可以生成整合 .NET API 其他元素的应用程序。

本概述适用于新用户，介绍了 WPF 的主要功能和概念。

使用 WPF 进行编程

WPF 作为大部分位于 System.Windows 命名空间中的 .NET 类型的一个子集存在。如果你之前使用托管技术（如 ASP.NET 和 Windows 窗体）通过 .NET 生成过应用程序，则不会对基本的 WPF 编程体验感到陌生；你可以使用最喜欢的 .NET 编程语言（如 C# 或 Visual Basic）来完成实例化类、设置属性、调用方法以及处理事件等操作。

WPF 还包括增强属性和事件的其他编程构造：依赖项属性和路由事件。

标记和代码隐藏

通过 WPF，可以使用标记和代码隐藏开发应用程序，这是 ASP.NET 开发人员已经熟悉的体验。通常使用 XAML 标记实现应用程序的外观，同时使用托管编程语言（代码隐藏）来实现其行为。这种外观和行为的分离具有以下优点：

降低了开发和维护成本，因为特定于外观的标记与特定于行为的代码不紧密耦合。
开发效率更高，因为设计人员在实现应用程序外观的同时，开发人员可以实现应用程序的行为。
WPF 应用程序的全球化和本地化得以简化。

标记

XAML 是一种基于 XML 的标记语言，以声明形式实现应用程序的外观。通常用它创建窗口、对话框、页和用户控件，并填充控件、形状和图形。

下面的示例使用 XAML 来实现包含一个按钮的窗口的外观：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Title="Window with Button"
    Width="250" Height="100">

  <!-- Add button to window -->
  <Button Name="button">Click Me!</Button>

</Window>

具体而言，此 XAML 通过分别使用 Window 和 Button 元素来定义窗口和按钮。每个元素均配置了特性（如 Window 元素的 Title 特性）来指定窗口的标题栏文本。在运行时，WPF 会将标记中定义的元素和特性转换为 WPF 类的实例。例如， Window 元素被转换为 Window 类的实例，该类的 Title 属性是 Title 特性的值。

下图显示上一个示例中的 XAML 定义的用户界面 (UI)：

A window that contains a button

由于 XAML 是基于 XML 的，因此使用它编写的 UI 汇集在嵌套元素的层次结构中，称为元素树。元素树提供了一种直观的逻辑方式来创建和管理 UI。

代码隐藏

应用程序的主要行为是实现响应用户交互的功能，包括处理事件（例如，单击菜单、工具栏或按钮）以及相应地调用业务逻辑和数据访问逻辑。在 WPF 中，在与标记相关联的代码中实现此行为。此类代码称为代码隐藏。下面的示例演示上一个示例的更新标记和代码隐藏：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.AWindow"
    Title="Window with Button"
    Width="250" Height="100">

  <!-- Add button to window -->
  <Button Name="button" Click="button_Click">Click Me!</Button>

</Window>

using System.Windows; // Window, RoutedEventArgs, MessageBox

namespace SDKSample
{
    public partial class AWindow : Window
    {
        public AWindow()
        {
            // InitializeComponent call is required to merge the UI
            // that is defined in markup with this class, including  
            // setting properties and registering event handlers
            InitializeComponent();
        }

        void button_Click(object sender, RoutedEventArgs e)
        {
            // Show message box when button is clicked.
            MessageBox.Show("Hello, Windows Presentation Foundation!");
        }
    }
}

Namespace SDKSample

    Partial Public Class AWindow
        Inherits System.Windows.Window

        Public Sub New()

            ' InitializeComponent call is required to merge the UI
            ' that is defined in markup with this class, including  
            ' setting properties and registering event handlers
            InitializeComponent()

        End Sub

        Private Sub button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)

            ' Show message box when button is clicked.
            MessageBox.Show("Hello, Windows Presentation Foundation!")

        End Sub

    End Class

End Namespace

在此示例中，代码隐藏实现派生自 Window 类的类。 x:Class 特性用于将标记与代码隐藏类相关联。从代码隐藏类的构造函数调用 InitializeComponent，以将标记中定义的 UI 与代码隐藏类合并在一起。（生成应用程序时即会生成 InitializeComponent，因此不需要手动实现它。）x:Class 和 InitializeComponent 的组合可确保在创建实现时正确地对其进行初始化。代码隐藏类还可实现按钮的 Click 事件的事件处理程序。单击该按钮后，事件处理程序会通过调用 System.Windows.MessageBox.Show 方法显示一个消息框。

下图显示单击该按钮后的结果：

A MessageBox

控件

应用程序模型带来的用户体验是构造的控件。在 WPF 中，控件是适用于 WPF 类这一类别的总括术语，这些类托管在窗口或页中、具有用户界面并实现一些行为。

有关详细信息，请参阅控件。

按功能分类的 WPF 控件

下面列出了内置的 WPF 控件：

按钮： Button 和 RepeatButton。
数据显示：DataGrid、ListView 和 TreeView。
日期显示和选项： Calendar 和 DatePicker。
对话框： OpenFileDialog、 PrintDialog和 SaveFileDialog。
数字墨迹： InkCanvas 和 InkPresenter。
文档： DocumentViewer、 FlowDocumentPageViewer、 FlowDocumentReader、 FlowDocumentScrollViewer和 StickyNoteControl。
输入： TextBox、 RichTextBox和 PasswordBox。
布局： Border、 BulletDecorator、 Canvas、 DockPanel、 Expander、 Grid、 GridView、 GridSplitter、 GroupBox、 Panel、 ResizeGrip、 Separator、 ScrollBar、 ScrollViewer、 StackPanel、 Thumb、 Viewbox、 VirtualizingStackPanel、 Window和 WrapPanel。
媒体： Image、 MediaElement和 SoundPlayerAction。
菜单： ContextMenu、 Menu和 ToolBar。
导航： Frame、 Hyperlink、 Page、 NavigationWindow和 TabControl。
选项： CheckBox、 ComboBox、 ListBox、 RadioButton和 Slider。
用户信息： AccessText、 Label、 Popup、 ProgressBar、 StatusBar、 TextBlock和 ToolTip。

输入和命令

最常检测和响应用户输入的控件。 WPF 输入系统使用直接事件和路由事件来支持文本输入、焦点管理和鼠标定位。

应用程序通常具有复杂的输入要求。 WPF 提供了命令系统，用于将用户输入操作与对这些操作做出响应的代码分隔开来。

Layout

创建用户界面时，按照位置和大小排列控件以形成布局。任何布局的一项关键要求都是适应窗口大小和显示设置的变化。 WPF 为你提供一流的可扩展布局系统，而不强制你编写代码以适应这些情况下的布局。

布局系统的基础是相对定位，这提高了适应不断变化的窗口和显示条件的能力。此外，该布局系统还可管理控件之间的协商以确定布局。协商是一个两步过程：首先，控件将需要的位置和大小告知父级；其次，父级将控件可以有的空间告知控件。

该布局系统通过基 WPF 类公开给子控件。对于通用的布局（如网格、堆叠和停靠），WPF 包括若干布局控件：

Canvas：子控件提供其自己的布局。
DockPanel：子控件与面板的边缘对齐。
Grid：子控件由行和列定位。
StackPanel：子控件垂直或水平堆叠。
VirtualizingStackPanel：子控件在水平或垂直的行上虚拟化并排列。
WrapPanel：子控件按从左到右的顺序定位，在当前行上的控件超出允许的空间时，换行到下一行。

下面的示例使用 DockPanel 布置几个 TextBox 控件：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.LayoutWindow"
    Title="Layout with the DockPanel" Height="143" Width="319">
  
  <!--DockPanel to layout four text boxes--> 
  <DockPanel>
    <TextBox DockPanel.Dock="Top">Dock = "Top"</TextBox>
    <TextBox DockPanel.Dock="Bottom">Dock = "Bottom"</TextBox>
    <TextBox DockPanel.Dock="Left">Dock = "Left"</TextBox>
    <TextBox Background="White">This TextBox "fills" the remaining space.</TextBox>
  </DockPanel>

</Window>

DockPanel 允许子 TextBox 控件，以告诉它如何排列这些控件。为了完成此操作，DockPanel 实现 Dock 附加了属性，该属性公开给子控件，以允许每个子控件指定停靠样式。

注意

由父控件实现以便子控件使用的属性是 WPF 构造，称为附加属性。

下图显示上一个示例中的 XAML 标记的结果：：

DockPanel page

数据绑定

大多数应用程序旨在为用户提供查看和编辑数据的方法。对于 WPF 应用程序，已对存储和访问数据的工作提供技术（如 SQL Server 和 ADO.NET）。访问数据并将数据加载到应用程序的托管对象后，WPF 应用程序的复杂工作开始。从根本上来说，这涉及到两件事：

将数据从托管对象复制到控件，在控件中可以显示和编辑数据。
确保使用控件对数据所做的更改将复制回托管对象。

为了简化应用程序开发，WPF 提供了一个数据绑定引擎来自动执行这些步骤。数据绑定引擎的核心单元是 Binding 类，其工作是将控件（绑定目标）绑定到数据对象（绑定源）。下图阐释了这种关系：

Basic data binding diagram

下一示例演示如何将 TextBox 绑定到自定义 Person 对象的实例。下面的代码演示了 Person 实现：

Namespace SDKSample

    Class Person

        Private _name As String = "No Name"

        Public Property Name() As String
            Get
                Return _name
            End Get
            Set(ByVal value As String)
                _name = value
            End Set
        End Property

    End Class

End Namespace

namespace SDKSample
{
    class Person
    {
        string name = "No Name";

        public string Name
        {
            get { return name; }
            set { name = value; }
        }
    }
}

下面的标记将 TextBox 绑定到自定义 Person 对象的实例：

 <Window
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     x:Class="SDKSample.DataBindingWindow">

   <!-- Bind the TextBox to the data source (TextBox.Text to Person.Name) -->
   <TextBox Name="personNameTextBox" Text="{Binding Path=Name}" />

 </Window>

Imports System.Windows ' Window

Namespace SDKSample

    Partial Public Class DataBindingWindow
        Inherits Window

        Public Sub New()
            InitializeComponent()

            ' Create Person data source
            Dim person As Person = New Person()

            ' Make data source available for binding
            Me.DataContext = person

        End Sub

    End Class

End Namespace

using System.Windows; // Window

namespace SDKSample
{
    public partial class DataBindingWindow : Window
    {
        public DataBindingWindow()
        {
            InitializeComponent();

            // Create Person data source
            Person person = new Person();

            // Make data source available for binding
            this.DataContext = person;
        }
    }
}

在此示例中， Person 类在代码隐藏中实例化并被设置为 DataBindingWindow的数据上下文。在标记中， Text 的 TextBox 属性被绑定至 Person.Name 属性（使用“{Binding ... }”XAML 语法）。此 XAML 告知 WPF 将 TextBox 控件绑定至窗口的 Person 属性中存储的 DataContext 对象。

WPF 数据绑定引擎提供了额外支持，包括验证、排序、筛选和分组。此外，数据绑定支持在标准 WPF 控件显示的用户界面不恰当时，使用数据模板来为数据绑定创建自定义的用户界面。

有关详细信息，请参阅数据绑定概述。

显卡

WPF 引入了一组广泛、可伸缩的灵活图形功能，具有以下优点：

图形与分辨率和设备均无关。 WPF 图形系统中的基本度量单位是与设备无关的像素（即 1/96 英寸），且不考虑实际屏幕分辨率，并为实现与分辨率和设备无关的呈现提供了基础。每个与设备无关的像素都会自动缩放，以匹配呈现它的系统的每英寸点数 (dpi) 设置。
精度更高。 WPF 坐标系统使用双精度浮点数字度量，而不是单精度数字。转换和不透明度值也表示为双精度数字。 WPF 还支持广泛的颜色域 (scRGB)，并集成了对管理来自不同颜色空间的输入的支持。
高级图形和动画支持。 WPF 通过为你管理动画场景简化了图形编程，你无需担心场景处理、呈现循环和双线性内插。此外，WPF 还提供了点击测试支持和全面的 alpha 合成支持。
硬件加速。 WPF 图形系统充分利用图形硬件来尽量降低 CPU 使用率。

二维形状

WPF 提供一个常用矢量绘制的二维形状库，如下图中所示的矩形和椭圆：

Ellipses and rectangles

形状的一个有趣功能是它们不只是用于显示；形状实现许多你期望的控件功能，包括键盘和鼠标输入。下面的示例演示要处理的 MouseUp 的 Ellipse 事件：

<Window 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.EllipseEventHandlingWindow"
    Title="Click the Ellipse">
    <Ellipse Name="clickableEllipse" Fill="Blue" MouseUp="clickableEllipse_MouseUp" />
</Window>

Imports System.Windows ' Window, MessageBox
Imports System.Windows.Input ' MouseButtonEventArgs

Namespace SDKSample

    Public Class EllipseEventHandlingWindow
        Inherits Window

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub clickableEllipse_MouseUp(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
            MessageBox.Show("You clicked the ellipse!")
        End Sub

    End Class

End Namespace

using System.Windows; // Window, MessageBox
using System.Windows.Input; // MouseButtonEventHandler

namespace SDKSample
{
    public partial class EllipseEventHandlingWindow : Window
    {
        public EllipseEventHandlingWindow()
        {
            InitializeComponent();
        }

        void clickableEllipse_MouseUp(object sender, MouseButtonEventArgs e)
        {
            // Display a message
            MessageBox.Show("You clicked the ellipse!");
        }
    }
}

下图显示了前面的代码生成的内容：

A window with the text

有关详细信息，请参阅 WPF 中的形状和基本绘图概述。

二维几何图形

WPF 提供的二维形状包含基本形状的标准集。但是，你可能需要创建自定义形状以帮助改进自定义用户界面的设计。为此，WPF 提供了几何图形。下图演示了使用几何图形来创建可直接绘制、用作画笔或用于剪辑其他形状和控件的自定义形状。

Path 对象可用于绘制封闭式或开放式形状、多个形状，甚至曲线形状。

Geometry 对象可用于剪辑、命中测试以及呈现二维图形数据。

Various uses of a path

有关详细信息，请参阅几何图形概述。

二维效果

WPF 二维功能的子集包括视觉效果，如渐变、位图、绘图、用视频绘画、旋转、缩放和倾斜。这些效果都可以使用画笔实现；下图演示了一些示例：

Illustration of different brushes

有关详细信息，请参阅 WPF 画笔概述。

三维呈现

WPF 还包括三维呈现功能，这些功能与二维图形集成，以创建更精彩、更有趣的用户界面。例如，下图显示呈现在三维形状上的二维图像：

Visual3D sample screen shot

有关详细信息，请参阅三维图形概述。

动画

WPF 动画支持可以使控件变大、抖动、旋转和淡出，以形成有趣的页面过渡等。你可以对大多数 WPF 类，甚至自定义类进行动画处理。下图显示了运行中的一个简单动画：

Images of an animated cube

有关详细信息，请参阅动画概述。

媒体

传达丰富内容的一种方法是使用视听媒体。 WPF 为图像、视频和音频提供特殊支持。

映像

图像对大多数应用程序很常见，WPF 提供多种方式来使用它们。下图显示一个用户界面，该用户界面中的列表框中包含缩略图图像。选中一个缩略图后，将显示该图像的原尺寸。

Thumbnail images and a full-size image

有关详细信息，请参阅图像概述。

视频和音频

MediaElement 控件能够播放视频和音频，并且其足够灵活，可以用作其他自定义媒体播放器的基础。下面的 XAML 标记实现一个媒体播放器：

<MediaElement 
  Name="myMediaElement" 
  Source="media/wpf.wmv" 
  LoadedBehavior="Manual" 
  Width="350" Height="250" />

下图中的窗口显示了运行中的 MediaElement 控件：

A MediaElement control with audio and video

有关详细信息，请参阅图形和多媒体。

文本和版式

为了促进高质量的文本呈现，WPF 提供以下功能：

OpenType 字体支持。
ClearType 增强功能。
利用硬件加速的高性能。
文本与媒体、图形和动画的集成。
国际字体支持和回退机制。

作为文本与图形集成的演示，下图显示了文本修饰的应用程序：

Text with various text decorations

有关详细信息，请参阅 Windows Presentation Foundation 中的版式。

自定义 WPF 应用

到目前为止，你已经了解用于开发应用程序的核心 WPF 构建块。你可以使用该应用程序模型来托管和交付应用程序内容，它主要由控件组成。若要简化用户界面中控件的排列，并确保保持该排列能够应对窗口大小和显示设置的更改，你可以使用 WPF 布局系统。由于大多数应用程序允许用户与数据交互，因此你可以使用数据绑定来减少将用户界面与数据集成的工作。若要增强你应用程序的可视化外观，可以使用 WPF 提供的综合图形、动画和媒体支持。

不过，在创建和管理真正独特且视觉效果非凡的用户体验时，基础知识通常是不够的。标准的 WPF 控件可能无法与你所需的应用程序外观集成。数据可能不会以最有效的方式显示。你应用程序的整体用户体验可能不适合 Windows 主题的默认外观和感觉。在许多方面，演示技术需要视觉扩展性，需要的程度与任何其他类型的扩展性一样。

为此，WPF 提供了多种机制用于创建独特的用户体验，包括控件、触发器、控件和数据模板、样式、用户界面资源以及主题和皮肤的丰富内容模型。

内容模型

大多数 WPF 控件的主要用途是显示内容。在 WPF 中，可以构成控件内容的项的类型和数目称为控件的 内容模型。某些控件可以包含一种内容类型的一个项；例如， TextBox 的内容是分配给 Text 属性的一个字符串值。下面的示例设置 TextBox 的内容：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.TextBoxContentWindow"
    Title="TextBox Content">

    <TextBox Text="This is the content of a TextBox." />
</Window>

下图显示结果：

A TextBox control that contains text

但是，其他控件可以包含不同内容类型的多个项； Button的内容（由 Content 属性指定）可以包含各种项（包括布局控件、文本、图像和形状）。下面的示例演示了 Button，其内容包括 DockPanel、Label、Border 和 MediaElement：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.ButtonContentWindow"
    Title="Button Content">

  <Button Margin="20">
    <!-- Button Content -->
    <DockPanel Width="200" Height="180">
      <Label DockPanel.Dock="Top" HorizontalAlignment="Center">Click Me!</Label>
      <Border Background="Black" BorderBrush="Yellow" BorderThickness="2"
        CornerRadius="2" Margin="5">
        <MediaElement Source="media/wpf.wmv" Stretch="Fill" />
      </Border>
    </DockPanel>
  </Button>
</Window>

下图显示此按钮的内容：

A button that contains multiple types of content

有关各种控件支持的内容类型的详细信息，请参阅 WPF 内容模型。

触发器

尽管 XAML 标记的主要用途是实现应用程序的外观，你也可以使用 XAML 来实现应用程序行为的某些方面。其中一个示例是使用触发器来基于用户交互更改应用程序的外观。有关详细信息，请参阅样式和模板。

控件模板

WPF 控件的默认用户界面通常是从其他控件和形状构造的。例如， Button 由 ButtonChrome 和 ContentPresenter 控件组成。 ButtonChrome 提供了标准按钮外观，而 ContentPresenter 显示按钮的内容，正如 Content 属性所指定。

有时，某个控件的默认外观可能与应用程序的整体外观不一致。在这种情况下，可以使用 ControlTemplate 更改控件的用户界面的外观，而不更改其内容和行为。

下面的示例演示如何使用 Button 更改 ControlTemplate 的外观：

<Window 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.ControlTemplateButtonWindow"
  Title="Button with Control Template" Height="158" Width="290">

  <!-- Button using an ellipse -->
  <Button Content="Click Me!" Click="button_Click">
    <Button.Template>
      <ControlTemplate TargetType="{x:Type Button}">
        <Grid Margin="5">
          <Ellipse Stroke="DarkBlue" StrokeThickness="2">
            <Ellipse.Fill>
              <RadialGradientBrush Center="0.3,0.2" RadiusX="0.5" RadiusY="0.5">
                <GradientStop Color="Azure" Offset="0.1" />
                <GradientStop Color="CornflowerBlue" Offset="1.1" />
              </RadialGradientBrush>
            </Ellipse.Fill>
          </Ellipse>
          <ContentPresenter Name="content" HorizontalAlignment="Center" 
            VerticalAlignment="Center"/>
        </Grid>
      </ControlTemplate>
    </Button.Template>

  </Button>

</Window>

using System.Windows; // Window, RoutedEventArgs, MessageBox

namespace SDKSample
{
    public partial class ControlTemplateButtonWindow : Window
    {
        public ControlTemplateButtonWindow()
        {
            InitializeComponent();
        }

        void button_Click(object sender, RoutedEventArgs e)
        {
            // Show message box when button is clicked
            MessageBox.Show("Hello, Windows Presentation Foundation!");
        }
    }
}

Imports System.Windows ' Window, RoutedEventArgs, MessageBox

Namespace SDKSample

    Public Class ControlTemplateButtonWindow
        Inherits Window

        Public Sub New()

            InitializeComponent()

        End Sub

        Private Sub button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            MessageBox.Show("Hello, Windows Presentation Foundation!")
        End Sub

    End Class

End Namespace

在此示例中，默认按钮用户界面已被替换为 Ellipse ，它具有深蓝色边框并使用 RadialGradientBrush进行填充。 ContentPresenter 控件显示内容 Button"Click Me!"。单击 Button 时，仍会引发 Click 事件，这是 Button 控件的默认行为。结果如下图所示：

An elliptical button and a second window

数据模板

使用控件模板可以指定控件的外观，而使用数据模板则可以指定控件内容的外观。数据模板经常用于改进绑定数据的显示方式。下图显示 ListBox 的默认外观，它绑定到 Task 对象的集合，其中每个任务都具有名称、描述和优先级：

A list box with the default appearance

默认外观是你对 ListBox的期望。但是，每个任务的默认外观仅包含任务名称。若要显示任务名称、描述和优先级，必须使用 ListBox 更改 DataTemplate控件绑定列表项的默认外观。下面的 XAML 定义了此类 DataTemplate，它通过使用 ItemTemplate 属性应用于每个任务：

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.DataTemplateWindow"
  Title="With a Data Template">
  <Window.Resources>
    <!-- Data Template (applied to each bound task item in the task collection) -->
    <DataTemplate x:Key="myTaskTemplate">
      <Border Name="border" BorderBrush="DarkSlateBlue" BorderThickness="2"
        CornerRadius="2" Padding="5" Margin="5">
        <Grid>
          <Grid.RowDefinitions>
            <RowDefinition/>
            <RowDefinition/>
            <RowDefinition/>
          </Grid.RowDefinitions>
          <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto" />
            <ColumnDefinition />
          </Grid.ColumnDefinitions>
          <TextBlock Grid.Row="0" Grid.Column="0" Padding="0,0,5,0" Text="Task Name:"/>
          <TextBlock Grid.Row="0" Grid.Column="1" Text="{Binding Path=TaskName}"/>
          <TextBlock Grid.Row="1" Grid.Column="0" Padding="0,0,5,0" Text="Description:"/>
          <TextBlock Grid.Row="1" Grid.Column="1" Text="{Binding Path=Description}"/>
          <TextBlock Grid.Row="2" Grid.Column="0" Padding="0,0,5,0" Text="Priority:"/>
          <TextBlock Grid.Row="2" Grid.Column="1" Text="{Binding Path=Priority}"/>
        </Grid>
      </Border>
    </DataTemplate>
  </Window.Resources>

  <!-- UI -->
  <DockPanel>
    <!-- Title -->
    <Label DockPanel.Dock="Top" FontSize="18" Margin="5" Content="My Task List:"/>

    <!-- Data template is specified by the ItemTemplate attribute -->
    <ListBox
      ItemsSource="{Binding}"
      ItemTemplate="{StaticResource myTaskTemplate}"
      HorizontalContentAlignment="Stretch"
      IsSynchronizedWithCurrentItem="True"
      Margin="5,0,5,5" />

 </DockPanel>
</Window>

下图显示了此代码的作用：

List box that uses a data template

注意， ListBox 已保留其行为和整体外观；仅列表框显示的内容外观已更改。

有关详细信息，请参阅数据模板化概述。

样式

通过样式功能，开发人员和设计人员能够对其产品的特定外观进行标准化。 WPF 提供了一个强样式模型，其基础是 Style 元素。下面的示例创建一个样式，该样式将窗口上的每个 Button 的背景色设置为 Orange：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.StyleWindow"
    Title="Styles">
    
    <Window.Resources>
        <!-- Style that will be applied to all buttons for this window -->
        <Style TargetType="{x:Type Button}">
            <Setter Property="Background" Value="Orange" />
            <Setter Property="BorderBrush" Value="Crimson" />
            <Setter Property="FontSize" Value="20" />
            <Setter Property="FontWeight" Value="Bold" />
            <Setter Property="Margin" Value="5" />
        </Style>
    </Window.Resources>
    <StackPanel>

        <!-- This button will have the style applied to it -->
        <Button>Click Me!</Button>

        <!-- This label will not have the style applied to it -->
        <Label>Don't Click Me!</Label>

        <!-- This button will have the style applied to it -->
        <Button>Click Me!</Button>
        
    </StackPanel>
</Window>

由于此样式针对所有 Button 控件，因此将自动应用于窗口中的所有按钮，如下图所示：

Two orange buttons

有关详细信息，请参阅样式和模板。

资源

应用程序中的控件应共享相同的外观，它可以包括从字体和背景色到控件模板、数据模板和样式的所有内容。你可以对用户界面资源使用 WPF 支持，以将这些资源封装在一个位置以便重复使用。

下面的示例定义 Button 和 Label共享的通用背景色：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.ResourcesWindow"
    Title="Resources Window">

  <!-- Define window-scoped background color resource -->
  <Window.Resources>
    <SolidColorBrush x:Key="defaultBackground" Color="Red" />
  </Window.Resources>

  <!-- Button background is defined by window-scoped resource -->
  <Button Background="{StaticResource defaultBackground}">One Button</Button>

  <!-- Label background is defined by window-scoped resource -->
  <Label Background="{StaticResource defaultBackground}">One Label</Label>
</Window>

此示例通过使用 Window.Resources 属性元素实现背景色资源。此资源可供 Window的所有子级使用。有各种资源作用域，具体如下（按解析顺序列出）：

单个控件（使用继承的 System.Windows.FrameworkElement.Resources 属性）。
Window 或 Page （也使用继承的 System.Windows.FrameworkElement.Resources 属性）。
Application （使用 System.Windows.Application.Resources 属性）。

这些不同种类的作用域在定义和共享资源的方式方面为你提供了灵活性。

作为直接将你的资源与特定作用域关联的替代方法，可以通过使用单独的 ResourceDictionary （可以在应用程序的其他部分引用）打包一个或多个资源。例如，下面的示例定义资源字典中的默认背景色：

<ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

  <!-- Define background color resource -->
  <SolidColorBrush x:Key="defaultBackground" Color="Red" />

  <!-- Define other resources -->
</ResourceDictionary>

下面的示例引用上一个示例中定义的资源字典，以便在应用程序中共享它：

<Application
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.App">

  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="BackgroundColorResources.xaml"/>
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

资源和资源字典是 WPF 主题和皮肤支持的基础。

有关详细信息，请参阅资源。

自定义控件

尽管 WPF 提供了大量自定义支持，但你仍可能会遇到现有 WPF 控件不满足你的应用程序或其用户的需求的情况。出现这种情况的原因有：

不能通过自定义现有 WPF 实现的外观和感觉创建所需的用户界面。
现有 WPF 实现不支持（或很难支持）所需的行为。

但是，此时，你可以充分利用三个 WPF 模型中的一个来创建新的控件。每个模型都针对一个特定的方案并要求你的自定义控件派生自特定 WPF 基类。下面列出了这三个模型：

用户控件模型。自定义控件派生自 UserControl 并由一个或多个其他控件组成。
控件模型。自定义控件派生自 Control ，并用于生成使用模板将其行为与其外观分隔开来的实现，非常类似大多数 WPF 控件。派生自 Control 使得你可以更自由地创建自定义用户界面（相较用户控件），但它可能需要花费更多精力。
框架元素模型。当其外观由自定义呈现逻辑（而不是模板）定义时，自定义控件派生自 FrameworkElement 。

下面的示例演示一个派生自 UserControl 的自定义数值加/减控件：

<UserControl
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.NumericUpDown">

  <Grid>

    <Grid.RowDefinitions>
      <RowDefinition/>
      <RowDefinition/>
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
      <ColumnDefinition/>
      <ColumnDefinition/>
    </Grid.ColumnDefinitions>

    <!-- Value text box -->
    <Border BorderThickness="1" BorderBrush="Gray" Margin="2" Grid.RowSpan="2" 
      VerticalAlignment="Center" HorizontalAlignment="Stretch">
      <TextBlock Name="valueText" Width="60" TextAlignment="Right" Padding="5"/>
    </Border>

    <!-- Up/Down buttons -->
    <RepeatButton Name="upButton" Click="upButton_Click" Grid.Column="1" 
      Grid.Row="0">Up</RepeatButton>
    <RepeatButton Name="downButton" Click="downButton_Click" Grid.Column="1" 
      Grid.Row="1">Down</RepeatButton>

  </Grid>

</UserControl>

using System; // EventArgs
using System.Windows; // DependencyObject, DependencyPropertyChangedEventArgs,
                      // FrameworkPropertyMetadata, PropertyChangedCallback,
                      // RoutedPropertyChangedEventArgs
using System.Windows.Controls; // UserControl

namespace SDKSample
{
    public partial class NumericUpDown : UserControl
    {
        // NumericUpDown user control implementation
    }
}

imports System 'EventArgs
imports System.Windows 'DependencyObject, DependencyPropertyChangedEventArgs, 
                       ' FrameworkPropertyMetadata, PropertyChangedCallback, 
                       ' RoutedPropertyChangedEventArgs
imports System.Windows.Controls 'UserControl

Namespace SDKSample

    ' Interaction logic for NumericUpDown.xaml
    Partial Public Class NumericUpDown
        Inherits System.Windows.Controls.UserControl

        'NumericUpDown user control implementation

    End Class

End Namespace

下面的示例说明了将用户控件合并到 Window 所需的 XAML：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.UserControlWindow"
    xmlns:local="clr-namespace:SDKSample" 
    Title="User Control Window">

  <!-- Numeric Up/Down user control -->
  <local:NumericUpDown />

</Window>

下图显示了 NumericUpDown 中托管的 Window 控件：

A custom UserControl

有关自定义控件的详细信息，请参阅控件创作概述。

WPF 最佳做法

与任何开发平台一样，可以采用多种方式使用 WPF 以实现所需的结果。为确保你的 WPF 应用程序提供所需的用户体验并满足一般用户的需求，针对辅助功能、全球化和本地化以及性能提供了一些建议的最佳做法。有关详细信息，请参阅：

后续步骤

我们已经了解了 WPF 的主要功能。现在可以生成你的第一个 WPF 应用。

演练：我的第一个 WPF 桌面应用