通过

位图效果概述

  • 项目

位图效果使设计人员和开发人员能够将视觉效果应用于呈现的 Windows Presentation Foundation (WPF) 内容。 例如，使用位图效果，可以轻松地将 DropShadowBitmapEffect 效果或模糊效果应用到图像或按钮。

重要

在 .NET Framework 4 或更高版本中，BitmapEffect 类已过时。 如果尝试使用 BitmapEffect 类，将发生已过时异常。 BitmapEffect 类的未过时替代项是 Effect 类。 在大多数情况下，Effect 类明显更快。

WPF 位图效果

位图效果（BitmapEffect 对象）是简单的像素处理操作。 位图效果将 BitmapSource 作为输入，并在应用效果（例如模糊或投影）后生成新的 BitmapSource。 每个位图效果都公开了可以控制筛选属性的属性，例如 BlurBitmapEffect 的 Radius。

作为一种特殊情况，在 WPF 中，可以将效果设置为实时 Visual 对象（例如 Button 或 TextBox）上的属性。 像素处理在运行时应用并呈现。 在这种情况下，在呈现时，Visual 会自动转换为其等效的 BitmapSource，并作为输入提供给 BitmapEffect。 输出替换 Visual 对象的默认呈现行为。 这就是为什么 BitmapEffect 对象仅强制在软件中呈现视觉对象，即在应用效果时不对视觉对象进行硬件加速。

注意

WPF 位图效果在软件模式下呈现。 应用效果的任何对象也都将以软件形式呈现。 在大型视觉对象上使用位图效果或对位图效果的属性进行动画处理时，性能的下降幅度最大。 这并不表示完全不应该以这种方式使用位图效果，而是应谨慎使用，并进行全面测试以确保用户得到预期的体验。

注意

WPF 位图效果不支持部分信任执行。 应用程序必须具有完全信任权限才能使用位图效果。

如何应用效果

BitmapEffect 是 Visual 上的属性。 因此，将效果应用于视觉对象（例如 Button、Image、DrawingVisual 或 UIElement）就像设置属性一样简单。 BitmapEffect 可以设置为单个 BitmapEffect 对象，也可以使用 BitmapEffectGroup 对象链接多个效果。

以下示例演示如何在 Extensible Application Markup Language (XAML) 中应用 BitmapEffect。

<Button  Width="200">You Can't Read This!
  <Button.BitmapEffect>

  <!-- <BitmapEffectGroup> would go here if you wanted to apply more 
         then one effect to the Button. However, in this example only  
         one effect is being applied so BitmapEffectGroup does not need  
         to be included. -->

    <!-- The larger the Radius, the more blurring. The default range is 20.
         In addition, the KernelType is set to a box kernel. A box kernel
         creates less disruption (less blur) then the default Gaussian kernel. -->
    <BlurBitmapEffect Radius="10" KernelType="Box" />

  </Button.BitmapEffect>
</Button>

以下示例演示如何在代码中应用 BitmapEffect。

// Get a reference to the Button.
Button myButton = (Button)sender;

// Initialize a new BlurBitmapEffect that will be applied
// to the Button.
BlurBitmapEffect myBlurEffect = new BlurBitmapEffect();

// Set the Radius property of the blur. This determines how
// blurry the effect will be. The larger the radius, the more
// blurring.
myBlurEffect.Radius = 10;

// Set the KernelType property of the blur. A KernalType of "Box"
// creates less blur than the Gaussian kernal type.
myBlurEffect.KernelType = KernelType.Box;

// Apply the bitmap effect to the Button.
myButton.BitmapEffect = myBlurEffect;

注意

当 BitmapEffect 应用于布局容器（例如 DockPanel 或 Canvas）时，效果将应用于元素或视觉对象的视觉树，包括其所有子元素。

创建自定义效果

WPF 还提供非托管接口，用于创建可在托管 WPF 应用程序中使用的自定义效果。 有关创建自定义位图效果的其他参考资料，请参阅非托管 WPF 位图效果文档。

另请参阅