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 と 1 つ以上のレシーバー UIElement の間の相対的な x、y、z 座標に基づいてシャドウを描画できます。この UIElement は、その上にキャスターの影がレンダリングされます。

ThemeShadow では、四角形の影のみがサポートされます。 カスタム シャドウ効果の場合は、 DropShadow を使用できます。

ポップアップの ThemeShadows

ThemeShadow は 、ポップアップ内の任意の XAML 要素に適用されると、自動的にシャドウをキャストします。 その背後にあるアプリの背景コンテンツとその下の他の開いているポップアップに影を落とします。

ポップアップで ThemeShadow を使用するには、 UIElement.Shadow プロパティを使用して、XAML 要素に ThemeShadow を適用します。 次に、 UIElement.Translation プロパティの z コンポーネントを使用するなどして、その背後にある他の要素から要素を昇格します。 ほとんどのポップアップ UI では、アプリの背景コンテンツに対して推奨される既定の昇格は 32 有効ピクセルです。

他の要素内のThemeShadow

Popup に含まれていない XAML 要素からシャドウをキャストするには、ThemeShadow.Receivers コレクションでシャドウを受け取ることができる他の要素を明示的に指定する必要があります。 レシーバーをビジュアル ツリー内のキャスターの先祖にすることはできません。

ThemeShadow のパフォーマンスのベスト プラクティス

1. カスタムレシーバー要素の数を必要最小限に制限します。

2. 複数の受信側要素が同じ昇格にある場合は、代わりに単一の親要素をターゲットにして、それらを結合してみてください。

3. 複数の要素が同じ種類のシャドウを同じ受信側要素にキャストする場合は、共有リソースとしてシャドウを追加して再利用します。

こちらもご覧ください

• Shadow
• Z 深度と影