次の方法で共有


AcrylicBrush クラス

定義

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

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)]
[WebHostHidden]
class AcrylicBrush : XamlCompositionBrushBase
/// [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
継承
属性

Windows の要件

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

先端

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

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

アクリル ブラシを追加するには、ダーク テーマ、ライト テーマ、ハイ コントラスト テーマの 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)

適用対象

こちらもご覧ください