ThemeShadow 類別

定義

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ThemeShadow : Shadow

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ThemeShadow : Shadow

Public Class ThemeShadow
Inherits Shadow

繼承

Object IInspectable DependencyObject Shadow ThemeShadow

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

備註

ThemeShadow 可以套用到任何 XAML 元素，根據概念施法者 UIElement 與一個或多個接收者 UIElement 之間的相對 x、y、z 座標繪製陰影。

ThemeShadow 僅支援矩形陰影。 自訂陰影效果可以用 DropShadow。

彈出視窗中的主題陰影

當在彈出視窗中套用任何 XAML 元素時，ThemeShadow 會自動投射陰影。 它會在背後的應用程式背景內容以及下方其他開啟的彈出視窗投下陰影。

若要使用 ThemeShadow 搭配彈出視窗，請使用 UIElement.Shadow 屬性將 ThemeShadow 套用到 XAML 元素。 接著，將該元素從後方其他元素中升格，例如利用 UIElement.Translation 屬性中的 z 元件。 大多數彈出式介面的建議預設高度相對於應用程式背景內容的有效高度是 32 像素。

其他元素中的主題陰影

若要從不在 彈出視窗中的 XAML 元素投射陰影，必須明確指定 ThemeShadow.Receivers 集合中其他可接收陰影的元素。 接收者不能是視覺樹中發送者的祖先。

ThemeShadow 的效能最佳實務

1. 將自訂接收元件數量限制在必要的最低標準。

2. 如果多個接收元件高度相同，則嘗試將它們合併，針對單一母元件。

3. 如果多個元素會將相同類型的陰影投射到相同的接收元件上，那就把該陰影加成共用資源並重複使用。

另請參閱

• Shadow
• Z深度與陰影