AcrylicBrush クラス

定義

名前空間:

Windows.UI.Xaml.Media

ぼかしやノイズ テクスチャなどの複数の効果を使用する半透明のマテリアルで領域を塗りつぶします。

UWP用の WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AcrylicBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

継承

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)

例

先端

詳細、設計ガイダンス、およびコード例については、「アクリル素材の」を参照してください。

WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを 開き、アクリルの動作を確認してください。

• WinUI 2 ギャラリー アプリ (Microsoft Store) を取得する
• ソース コードを取得する (GitHub)

アクリル ブラシを追加するには、ダーク テーマ、ライト テーマ、ハイ コントラスト テーマの 3 つのリソースを定義します。 ハイ コントラストでは、濃色/明るい AcrylicBrush と同じ x:Key を持つ SolidColorBrush を使用することをお勧めします。

手記

TintLuminosityOpacity 値を指定しない場合、システムは TintColor と TintOpacity に基づいて値を自動的に調整します。

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FF7F0000"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="MyAcrylicBrush"
            Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="Light">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FFFF7F7F"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

この例では、コードで AcrylicBrush を作成する方法を示します。 アプリで複数の OS ターゲットがサポートされている場合は、使用する前に、この API がユーザーのコンピューターで使用できることを確認してください。

if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.UI.Xaml.Media.AcrylicBrush"))
{
    Windows.UI.Xaml.Media.AcrylicBrush myBrush = new Windows.UI.Xaml.Media.AcrylicBrush();
    myBrush.BackgroundSource = Windows.UI.Xaml.Media.AcrylicBackgroundSource.HostBackdrop;
    myBrush.TintColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.FallbackColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.TintOpacity = 0.6;

    grid.Fill = myBrush;
}
else
{
    SolidColorBrush myBrush = new SolidColorBrush(Color.FromArgb(255, 202, 24, 37));

    grid.Fill = myBrush;
}

注釈

バージョン履歴

Windows バージョン	SDK のバージョン	付加価値
1903	18362	TintLuminosityOpacity

コンストラクター

AcrylicBrush()

AcrylicBrush クラスの新しいインスタンスを初期化します。 UWP用の WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。

プロパティ

AlwaysUseFallback	ブラシを強制的に純色にするかどうかを指定する値を取得または設定します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
AlwaysUseFallbackProperty	AlwaysUseFallback 依存関係プロパティを識別します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
BackgroundSource	アプリのコンテンツまたはアプリ ウィンドウの背後にあるコンテンツからブラシをサンプリングするかどうかを指定する値を取得または設定します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource を します (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
BackgroundSourceProperty	BackgroundSource 依存関係プロパティを識別します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
CompositionBrush	この XAML ブラシで使用 CompositionBrush を取得または設定します。 (継承元 XamlCompositionBrushBase)
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが非 UI スレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
FallbackColor	CompositionBrush をレンダリングできない場合にレンダリングに使用する色。 (継承元 XamlCompositionBrushBase)
Opacity	ブラシの不透明度を取得または設定します。 (継承元 Brush)
RelativeTransform	相対座標を使用してブラシに適用される変換を取得または設定します。 (継承元 Brush)
TintColor	半透明のアクリル素材の色の濃淡を取得または設定します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
TintColorProperty	TintColor 依存関係プロパティを識別します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
TintLuminosityOpacity	TintColor とアクリル サーフェスの背後にある基になるピクセルの間の明るさの量を取得または設定します。 UWP用の WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
TintLuminosityOpacityProperty	TintLuminosityOpacity 依存関係プロパティ を識別します。 UWP用の WinUI 2 API と同等 : Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
TintOpacity	色の濃淡の不透明度を取得または設定します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
TintOpacityProperty	TintOpacity 依存関係プロパティを識別します。 UWP用の WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
TintTransitionDuration	TintColor が変更されたときに使用される自動切り替えアニメーションの長さを取得または設定します。 UWP用 WinUI 2 API と同等の : Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間のを参照してください)。
TintTransitionDurationProperty	TintTransitionDuration 依存関係プロパティを識別します。 UWP用の WinUI 2 API と同等 : Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (Windows App SDKの WinUI の場合は、Windows App SDK 名前空間を参照してください)。
Transform	ブラシに適用される変換を取得または設定します。 (継承元 Brush)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObjectから依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
OnConnected()	要素を描画するために画面上でブラシが最初に使用されたときに呼び出されます。 派生クラスで実装する場合は、CompositionBrush インスタンスを作成し、CompositionBrush プロパティを設定してフレームワークに提供できます。 OnDisconnected は、ブラシが要素の描画に使用されなくなったときに呼び出されます。 (継承元 XamlCompositionBrushBase)
OnDisconnected()	ブラシが要素の描画に使用されなくなったときに呼び出されます。 派生クラスで実装すると、コンポスト ブラシやその他のコンポジション リソースを安全に破棄できます。 OnConnected は、切断された後でブラシを使用して要素を描画する場合に再び呼び出されます。 (継承元 XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	アニメーション化できるプロパティを定義します。 (継承元 Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	派生クラスでオーバーライドされると、アニメーション化できるプロパティを定義します。 (継承元 Brush)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty への変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObjectの依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	registerPropertyChangedCallback呼び出して、以前に登録された変更通知を取り消します。 (継承元 DependencyObject)

こちらもご覧ください

• アクリル素材の概要