在 WPF 界面开发中自定义绘制图形是提升应用视觉效果和交互体验的核心技能。无论是制作数据可视化图表、设计自定义控件还是实现简单的绘图工具掌握矩形和椭圆的绘制方法都是基础中的基础。然而仅仅画出图形往往不够如何让图形按照我们的意图去填充和适应其容器空间才是让界面布局精准、美观的关键。这其中Stretch属性的设置扮演了至关重要的角色它直接决定了图形在有限空间内的“姿态”。本文将系统性地讲解在 C#/WPF 中绘制矩形和椭圆的核心技术并深入剖析Stretch枚举的四种模式None,Fill,Uniform,UniformToFill对图形渲染产生的具体影响。无论你是刚接触 WPF 图形系统的新手还是希望深化对布局和渲染理解的中级开发者都能通过本文获得一套从基础绘制到高级控制的完整解决方案。我们将从概念入手通过大量可运行的代码示例一步步带你掌握如何创建、定制并精确控制这些基本形状。1. 核心概念WPF 中的形状Shape与 Stretch 属性在深入代码之前我们需要理解两个核心概念WPF 的Shape类族和Stretch属性。1.1 WPF 的 Shape 类WPF 提供了一套用于绘制矢量图形的Shape派生类位于System.Windows.Shapes命名空间。这些类都是FrameworkElement意味着它们可以像按钮、文本框一样参与 WPF 的布局系统拥有尺寸、边距、对齐等属性。我们最常使用的两个基本形状就是Rectangle矩形和Ellipse椭圆。Ellipse的一个特例是正圆当它的Width和Height相等时即为圆形。1.2 Stretch 属性的意义Stretch属性定义了一个内容对于Shape来说就是其内部的几何图形如何拉伸以填充其分配到的空间。这个“分配到的空间”通常由形状的Width、Height属性或其父容器如Grid、Canvas的布局逻辑决定。Stretch是Shape类的一个关键属性它接受一个System.Windows.Media.Stretch枚举值。理解这个属性是控制图形最终呈现效果的核心。很多初学者发现图形没有按预期显示或者尺寸怪异问题往往就出在对Stretch的理解上。2. 环境准备与项目创建在开始绘制之前我们首先搭建一个简单的 WPF 项目环境。本文示例基于 .NET 6/8 的 WPF 项目但核心概念适用于 .NET Framework 4.x 及更高版本。2.1 创建项目打开 Visual Studio 2022。选择“创建新项目” - 搜索“WPF” - 选择“WPF 应用程序(.NET)”模板。为项目命名例如 “WpfShapeDrawingDemo”选择合适的位置和解决方案名称。确保目标框架选择 .NET 6.0 或 .NET 8.0长期支持版本更稳定。2.2 理解默认项目结构创建完成后你会看到几个主要文件MainWindow.xaml: 主窗口的界面定义文件。MainWindow.xaml.cs: 主窗口的后台代码文件。App.xaml: 应用程序级别的资源和启动设置。我们将主要在MainWindow.xaml中进行界面布局和形状定义并在MainWindow.xaml.cs中演示动态创建的代码。3. Stretch 枚举值深度解析Stretch枚举包含四个值它们的行为是本文的重点。为了直观理解我们假设有一个形状矩形或椭圆它有一个“自然大小”由其StrokeThickness和内部几何逻辑隐含决定同时它被放置在一个尺寸为WidthxHeight的“容器框”内这个框就是形状元素本身占用的布局空间。Stretch决定了形状的“内容”如何适配这个“框”。3.1 Stretch.None行为内容保持其自然大小不进行任何拉伸。它会在容器框内按照HorizontalAlignment和VerticalAlignment属性进行对齐默认是Center。视觉表现图形尺寸固定不受容器框大小变化的影响。如果容器框小于图形图形会被裁剪。适用场景需要固定尺寸的图标、标志或明确不希望被拉伸的图形。3.2 Stretch.Fill行为内容被拉伸以完全填满容器框。不保持宽高比。宽度和高度独立缩放以适应容器。视觉表现图形会变形以充满整个可用区域。一个圆会变成一个椭圆一个正方形会变成一个长方形。适用场景需要图形充满某个区域且不关心原始比例例如作为可拉伸的背景色块。3.3 Stretch.Uniform行为内容被等比例缩放以尽可能大地适应容器框同时完全显示在框内。缩放因子取(容器宽度/自然宽度)和(容器高度/自然高度)中的较小值。图形会居中显示两侧或上下可能出现空白区域。视觉表现图形保持原有比例完整显示但可能不会填满整个容器框。这是最常用的模式用于“适应”视图。适用场景显示图片、图标、图表等需要保持原始比例的视觉元素。3.4 Stretch.UniformToFill行为内容被等比例缩放以完全填满容器框。缩放因子取(容器宽度/自然宽度)和(容器高度/自然高度)中的较大值。由于容器框的宽高比可能与图形不同图形的一部分会被裁剪掉但填满的区域看不到空白。视觉表现图形保持比例但会放大直到没有空白代价是边缘内容可能被裁切。适用场景作为全屏背景或横幅要求无空白填充且可以接受边缘裁剪的情况。4. 实战在 XAML 中绘制矩形与椭圆并设置 StretchXAML 是声明式 UI 的首选方式清晰直观。我们在MainWindow.xaml中创建一个Grid并放置多个形状来对比Stretch的效果。4.1 基础绘制一个简单的矩形和椭圆首先我们绘制最基本的形状不显式设置Width/Height和Stretch观察默认行为。Window x:ClassWpfShapeDrawingDemo.MainWindow xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml TitleWPF Shape Stretch 演示 Height450 Width800 Grid StackPanel OrientationHorizontal HorizontalAlignmentCenter VerticalAlignmentCenter !-- 默认状态的矩形 -- Rectangle FillLightBlue StrokeDarkBlue StrokeThickness3 Margin10 Width100 Height60/ !-- 默认状态的椭圆 -- Ellipse FillLightCoral StrokeDarkRed StrokeThickness3 Margin10 Width100 Height60/ /StackPanel /Grid /WindowFill: 设置形状内部的填充画刷颜色、渐变等。Stroke: 设置形状轮廓线的画刷。StrokeThickness: 设置轮廓线的粗细。我们为它们设置了固定的Width和Height。此时由于没有显式设置Stretch其默认值为Stretch.Fill。但因为尺寸固定且与“自然大小”一致所以视觉上就是100x60的矩形和椭圆。4.2 对比四种 Stretch 模式接下来我们创建四个尺寸相同的Border作为容器在每个里面放置一个相同“自然大小”的椭圆但应用不同的Stretch值以直观对比差异。Window x:ClassWpfShapeDrawingDemo.MainWindow xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml TitleWPF Shape Stretch 演示 Height600 Width900 Grid Grid.RowDefinitions RowDefinition HeightAuto/ RowDefinition Height*/ /Grid.RowDefinitions TextBlock Grid.Row0 TextStretch 枚举值效果对比 (容器: 200x100椭圆初始: 80x40) FontSize16 FontWeightBold HorizontalAlignmentCenter Margin10/ UniformGrid Grid.Row1 Columns2 Rows2 !-- Stretch.None -- Border BorderBrushGray BorderThickness1 Margin20 Background#FFF0F0F0 StackPanel TextBlock TextStretch.None HorizontalAlignmentCenter FontWeightBold/ Ellipse FillLightGreen StrokeDarkGreen StrokeThickness2 Width80 Height40 StretchNone HorizontalAlignmentCenter VerticalAlignmentCenter/ /StackPanel /Border !-- Stretch.Fill -- Border BorderBrushGray BorderThickness1 Margin20 Background#FFF0F0F0 StackPanel TextBlock TextStretch.Fill HorizontalAlignmentCenter FontWeightBold/ Ellipse FillLightCoral StrokeDarkRed StrokeThickness2 Width80 Height40 StretchFill HorizontalAlignmentCenter VerticalAlignmentCenter/ /StackPanel /Border !-- Stretch.Uniform -- Border BorderBrushGray BorderThickness1 Margin20 Background#FFF0F0F0 StackPanel TextBlock TextStretch.Uniform HorizontalAlignmentCenter FontWeightBold/ Ellipse FillLightBlue StrokeDarkBlue StrokeThickness2 Width80 Height40 StretchUniform HorizontalAlignmentCenter VerticalAlignmentCenter/ /StackPanel /Border !-- Stretch.UniformToFill -- Border BorderBrushGray BorderThickness1 Margin20 Background#FFF0F0F0 StackPanel TextBlock TextStretch.UniformToFill HorizontalAlignmentCenter FontWeightBold/ Ellipse FillGold StrokeOrange StrokeThickness2 Width80 Height40 StretchUniformToFill HorizontalAlignmentCenter VerticalAlignmentCenter/ /StackPanel /Border /UniformGrid /Grid /Window关键点分析每个Ellipse的Width”80” Height”40”定义了其“自然大小”或“内容尺寸”。每个Ellipse被放在一个大约200x100的Border容器中由Margin和UniformGrid布局计算得出。Stretch”None”: 椭圆保持80x40大小在Border中居中显示周围留有大量空白。Stretch”Fill”: 椭圆被拉伸到填满整个Border分配给它的空间宽高比改变变成了一个更扁的椭圆。Stretch”Uniform”: 椭圆等比例放大直到宽度或高度触碰到Border的边界。由于容器宽高比 (~2:1) 与椭圆 (2:1) 相同它恰好填满没有空白也没有裁剪。如果比例不同则会有空白。Stretch”UniformToFill”: 椭圆等比例放大直到完全覆盖Border区域。由于本例中比例相同效果与Uniform一致。如果比例不同椭圆会被放大到超出边界边缘部分被裁剪。4.3 结合 Canvas 进行精确定位Canvas面板允许通过Canvas.Left和Canvas.Top进行绝对定位是绘制自由图形的理想容器。这里演示如何在Canvas中绘制叠加的图形并控制其Stretch。Window ... (同上) Grid Canvas Width400 Height300 BackgroundWhiteSmoke HorizontalAlignmentCenter VerticalAlignmentCenter !-- 一个被拉伸的矩形作为背景框 -- Rectangle Canvas.Left50 Canvas.Top50 Width300 Height200 Fill#20FF6347 StrokeTomato StrokeThickness1 StretchFill/ !-- 一个保持比例的椭圆 -- Ellipse Canvas.Left100 Canvas.Top80 Width150 Height150 Fill#406495ED StrokeRoyalBlue StrokeThickness3 StretchUniform/ !-- 一个不被拉伸的矩形边框 -- Rectangle Canvas.Left120 Canvas.Top100 Width80 Height80 FillTransparent StrokeGreen StrokeThickness2 StretchNone/ !-- 一段说明文字 -- TextBlock Canvas.Left60 Canvas.Top20 TextCanvas 中的图形与 Stretch FontWeightBold/ /Canvas /Grid /Window在Canvas中Width和Height结合Stretch决定了图形最终的视觉大小。Stretch”Uniform”的椭圆会在150x150的框内保持圆形因为宽高相等。Stretch”None”的矩形则严格按80x80绘制。5. 实战在 C# 代码中动态创建与操控形状有时我们需要根据数据或用户交互动态生成图形。这在后台代码C#中实现非常灵活。5.1 动态创建矩形和椭圆我们在MainWindow.xaml.cs的构造函数或某个事件处理程序中添加代码。首先在 XAML 中为动态创建的图形预留一个容器比如一个StackPanel并为其命名。!-- 在 MainWindow.xaml 的 Grid 中添加 -- StackPanel x:NameDynamicShapesPanel OrientationVertical Margin10 Button x:NameAddShapeButton Content动态添加形状 ClickAddShapeButton_Click Margin5 Padding10/ Border x:NameShapeContainer BorderBrushLightGray BorderThickness1 Height300 Margin5 Canvas x:NameDrawingCanvas/ /Border /StackPanel然后在后台代码文件中实现按钮点击事件。// MainWindow.xaml.cs using System.Windows; using System.Windows.Controls; using System.Windows.Media; using System.Windows.Shapes; namespace WpfShapeDrawingDemo { public partial class MainWindow : Window { private Random _random new Random(); public MainWindow() { InitializeComponent(); } private void AddShapeButton_Click(object sender, RoutedEventArgs e) { // 清空画布可选 // DrawingCanvas.Children.Clear(); // 1. 动态创建一个矩形 Rectangle dynamicRect new Rectangle(); dynamicRect.Width 80; dynamicRect.Height 60; // 设置位置 (在Canvas中) Canvas.SetLeft(dynamicRect, _random.Next(10, 250)); Canvas.SetTop(dynamicRect, _random.Next(10, 150)); // 设置外观 dynamicRect.Fill new SolidColorBrush(Color.FromRgb((byte)_random.Next(256), (byte)_random.Next(256), (byte)_random.Next(256))); dynamicRect.Stroke Brushes.Black; dynamicRect.StrokeThickness 2; // 关键设置 Stretch 属性 dynamicRect.Stretch Stretch.Fill; // 可以尝试改为其他枚举值 // 2. 动态创建一个椭圆 Ellipse dynamicEllipse new Ellipse(); dynamicEllipse.Width 70; dynamicEllipse.Height 70; // 宽高相等为正圆 Canvas.SetLeft(dynamicEllipse, _random.Next(10, 250)); Canvas.SetTop(dynamicEllipse, _random.Next(10, 150)); dynamicEllipse.Fill new SolidColorBrush(Color.FromArgb(180, (byte)_random.Next(256), (byte)_random.Next(256), (byte)_random.Next(256))); // 带透明度 dynamicEllipse.Stroke Brushes.DarkSlateGray; dynamicEllipse.StrokeThickness 1.5; dynamicEllipse.Stretch Stretch.Uniform; // 保持圆形 // 3. 将形状添加到 Canvas 的子元素集合中 DrawingCanvas.Children.Add(dynamicRect); DrawingCanvas.Children.Add(dynamicEllipse); // 4. 可选为形状添加交互例如鼠标点击事件 dynamicRect.MouseDown Shape_MouseDown; dynamicEllipse.MouseDown Shape_MouseDown; } private void Shape_MouseDown(object sender, System.Windows.Input.MouseButtonEventArgs e) { if (sender is Shape shape) { // 点击时改变边框颜色 shape.Stroke Brushes.Red; shape.StrokeThickness 4; } } } }5.2 运行时修改 Stretch 属性我们可以通过其他控件如ComboBox来动态改变已有图形的Stretch属性观察实时变化。在 XAML 中添加一个ComboBox和作为“目标”的形状。StackPanel Margin10 TextBlock Text动态切换 Stretch 属性 FontWeightBold/ ComboBox x:NameStretchSelector SelectedIndex0 SelectionChangedStretchSelector_SelectionChanged ComboBoxItem ContentNone/ ComboBoxItem ContentFill/ ComboBoxItem ContentUniform/ ComboBoxItem ContentUniformToFill/ /ComboBox Border BorderBrushGray BorderThickness1 Margin0,10 Padding20 BackgroundWhiteSmoke Ellipse x:NameTargetEllipse Width120 Height80 FillSkyBlue StrokeBlue StrokeThickness3/ /Border /StackPanel在后台代码中处理SelectionChanged事件。private void StretchSelector_SelectionChanged(object sender, SelectionChangedEventArgs e) { if (StretchSelector.SelectedItem is ComboBoxItem selectedItem) { string stretchMode selectedItem.Content.ToString(); Stretch newStretch; // 将字符串转换为 Stretch 枚举值 switch (stretchMode) { case None: newStretch Stretch.None; break; case Fill: newStretch Stretch.Fill; break; case Uniform: newStretch Stretch.Uniform; break; case UniformToFill: newStretch Stretch.UniformToFill; break; default: newStretch Stretch.Fill; break; } // 应用新的 Stretch 值到目标椭圆 TargetEllipse.Stretch newStretch; } }运行程序通过下拉框切换Stretch模式可以立即看到椭圆在固定容器内的适配方式变化这是理解Stretch行为最直观的方式。6. 常见问题与排查思路在使用 WPF 绘制形状和设置Stretch时你可能会遇到一些典型问题。问题现象可能原因排查与解决思路图形不显示1.Width或Height为 0 或未设置。2.Fill和Stroke均为null或Transparent。3. 图形在布局范围之外如Canvas位置负值过大。1. 检查形状的ActualWidth和ActualHeight属性在运行时。2. 至少为Fill或Stroke设置一个可见的画刷。3. 检查父容器的尺寸和裁剪属性ClipToBounds。图形尺寸与预期不符1. 未理解Stretch的默认值 (Fill)。2. 父容器如Grid、StackPanel的布局约束了形状的最终渲染尺寸。3.Stretch与HorizontalAlignment/VerticalAlignment共同作用产生意外效果。1. 明确设置Stretch属性而不是依赖默认值。2. 使用Grid的ShowGridLines或调试工具如 Snoop查看布局边界。3. 在固定尺寸的容器如Border内测试隔离布局影响。Stretch”Uniform”时图形未居中形状的HorizontalAlignment和VerticalAlignment可能不是Center默认是Center。显式设置HorizontalAlignment”Center”和VerticalAlignment”Center”。Stretch”None”时图形被裁剪形状的“自然大小”或显式设置的Width/Height超过了其容器分配的实际空间。1. 增大容器的尺寸。2. 减小形状的Width/Height。3. 检查容器的ClipToBounds是否为true。动态创建的图形看不到1. 图形未添加到可视化树中例如忘记Children.Add。2. 图形属性设置顺序有误某些属性依赖父容器。1. 确保将形状对象添加到了某个面板如Canvas,Grid的Children集合。2. 在添加到父容器后再设置依赖于布局的属性虽然通常没问题但有时是根源。7. 最佳实践与工程建议将形状绘制集成到实际项目中时遵循一些最佳实践可以提高代码的可维护性、性能和用户体验。7.1 资源与样式复用避免对每个形状进行重复的属性设置。使用Style和Resource进行统一管理。Window.Resources !-- 定义一个通用的形状样式 -- Style x:KeyCommonShapeStyle TargetTypeShape Setter PropertyStrokeThickness Value2/ Setter PropertyOpacity Value0.9/ Setter PropertyRenderOptions.BitmapScalingMode ValueHighQuality/ /Style !-- 定义一个特定于数据图表的矩形样式 -- Style x:KeyChartBarStyle TargetTypeRectangle BasedOn{StaticResource CommonShapeStyle} Setter PropertyFill Value#FF4A90E2/ Setter PropertyRadiusX Value2/ Setter PropertyRadiusY Value2/ Setter PropertyStretch ValueFill/ !-- 图表柱状通常填充 -- /Style /Window.Resources Grid Rectangle Style{StaticResource ChartBarStyle} Width50 Height120/ /Grid7.2 性能考量少用Canvas进行复杂静态布局对于大量静态图形如果布局简单使用Grid或UniformGrid可能比绝对定位的Canvas性能更好因为 WPF 布局系统能更好地优化。虚拟化当需要绘制成百上千个形状如大型图表时考虑使用VirtualizingCanvas如果自定义控件或第三方库只渲染可视区域内的元素。简化视觉树过度复杂的嵌套面板会影响渲染性能。确保可视化树简洁。7.3 数据绑定与 MVVM在 MVVM 模式中避免在后台代码中直接操作 UI 元素。可以通过数据绑定将形状的属性与 ViewModel 中的属性关联。对于复杂图形集合可以使用ItemsControl配合DataTemplate。!-- 假设 ViewModel 有一个 ObservableCollectionDataPoint Points 属性 -- ItemsControl ItemsSource{Binding Points} ItemsControl.ItemsPanel ItemsPanelTemplate Canvas/ /ItemsPanelTemplate /ItemsControl.ItemsPanel ItemsControl.ItemTemplate DataTemplate Ellipse Width{Binding Size} Height{Binding Size} Fill{Binding Color} Canvas.Left{Binding X} Canvas.Top{Binding Y} Ellipse.Style Style TargetTypeEllipse Setter PropertyStretch ValueUniform/ /Style /Ellipse.Style /Ellipse /DataTemplate /ItemsControl.ItemTemplate /ItemsControl7.4 交互与动画WPF 形状完美支持 WPF 的动画和触发器系统。你可以为Fill、StrokeThickness、RenderTransform等属性添加动画以响应用户交互如鼠标悬停、点击。Rectangle Width100 Height60 FillLightGray StrokeBlack Rectangle.Style Style TargetTypeRectangle Style.Triggers Trigger PropertyIsMouseOver ValueTrue Trigger.EnterActions BeginStoryboard Storyboard ColorAnimation ToOrange Duration0:0:0.2 Storyboard.TargetProperty(Shape.Fill).(SolidColorBrush.Color)/ DoubleAnimation To5 Duration0:0:0.2 Storyboard.TargetPropertyStrokeThickness/ /Storyboard /BeginStoryboard /Trigger.EnterActions Trigger.ExitActions BeginStoryboard Storyboard ColorAnimation ToLightGray Duration0:0:0.5 Storyboard.TargetProperty(Shape.Fill).(SolidColorBrush.Color)/ DoubleAnimation To1 Duration0:0:0.5 Storyboard.TargetPropertyStrokeThickness/ /Storyboard /BeginStoryboard /Trigger.ExitActions /Trigger /Style.Triggers /Style /Rectangle.Style /Rectangle掌握Rectangle、Ellipse等基本形状的绘制和Stretch属性的控制是构建丰富 WPF 界面的基石。从静态声明到动态创建从基础属性到高级交互理解每个环节背后的原理特别是布局与渲染的协同至关重要。Stretch的四种模式提供了从“严格保持原样”到“完全适应空间”的完整策略谱系正确选择可以解决大部分图形尺寸适配问题。建议读者在理解本文示例的基础上动手修改参数观察变化并尝试将其应用到自己的项目场景中例如自定义进度条、状态指示灯、简单的图表绘制等从而真正内化这些知识。