共用方式為

點陣圖效果概觀

  • 發行項

點陣圖效果可讓設計人員和開發人員將視覺效果套用至轉譯的 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 應用程式中使用的自訂效果。 如需建立自訂點陣圖效果的其他參考資料，請參閱 Unmanaged WPF 點陣圖效果 (英文) 文件。

另請參閱