AcrylicBrush Класс

Определение

Красит область с полупрозрачным материалом, который использует несколько эффектов, включая размытие и текстуру шума.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

/// [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, щелкните здесь, чтобы открыть приложение и увидеть Акрил в действии.

Чтобы добавить акриловую кисть, определите три ресурса для темных, светлых и высококонтрастных тем. Обратите внимание, что в высокой контрастности рекомендуется использовать SolidColorBrush с той же x:Key, что и темная/светлая акриловая ручка.

Заметка

Если значение 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>

В этом примере показано, как создать АкрилБруш в коде. Если приложение поддерживает несколько целевых объектов ОС, убедитесь, что этот 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.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

Свойства

AlwaysUseFallback

Возвращает или задает значение, указывающее, вынуждена ли кисть к твердому резервному цвету.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (для WinUI в пакете SDK для приложений Windowsсм. пространства имен пакета SDK для Приложений Windows).

AlwaysUseFallbackProperty

Определяет свойство зависимостей AlwaysUseFallback.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

BackgroundSource

Возвращает или задает значение, указывающее, будут ли примеры кисти из содержимого приложения или содержимого в окне приложения.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

BackgroundSourceProperty

Определяет свойство зависимости BackgroundSource.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (для WinUI в пакете SDK для приложений Windowsсм. пространства имен пакета SDK для Приложений Windows).

CompositionBrush

Возвращает или задает CompositionBrush, используемой этой кистью XAML.

(Унаследовано от XamlCompositionBrushBase)
Dispatcher

Возвращает CoreDispatcher, с которым связан этот объект. CoreDispatcher представляет собой объект, который может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, отличным от пользовательского интерфейса.

(Унаследовано от DependencyObject)
FallbackColor

Цвет, используемый для отрисовки, если не удается отобразить CompositionBrush.

(Унаследовано от XamlCompositionBrushBase)
Opacity

Возвращает или задает степень непрозрачности кисти.

(Унаследовано от Brush)
RelativeTransform

Возвращает или задает преобразование, которое применяется к кисти с помощью относительных координат.

(Унаследовано от Brush)
TintColor

Получает или задает цвет для полупрозрачного акрилового материала.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

TintColorProperty

Определяет свойство зависимостей TintColor.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

TintLuminosityOpacity

Получает или задает величину яркости между TintColor и базовыми пикселями за акриловой поверхностью.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (для WinUI впакете SDK для приложений Windows см. пространства имен пакета SDK для приложений Windows).

TintLuminosityOpacityProperty

Определяет свойство зависимости TintLuminosityOpacity.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

TintOpacity

Возвращает или задает степень непрозрачности цвета.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для приложений Windows).

TintOpacityProperty

Определяет свойство зависимостей TintOpacity.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (для WinUI впакете SDK для приложений Windows см. пространства имен пакета SDK для Приложений Windows).

TintTransitionDuration

Возвращает или задает длину анимации автоматического перехода, используемой при изменении TintColor.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (для WinUI в пакете SDK для приложений Windowsсм.пространства имен пакета SDK для windows).

TintTransitionDurationProperty

Определяет свойство зависимости TintTransitionDuration.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (для WinUI в пакете SDK для приложений Windowsсм. пространства имен пакета SDK для Приложений Windows).

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)

Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObj ect.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей в DependencyObject.

(Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменении, которое было зарегистрировано ранее путем вызова RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)

Применяется к

См. также раздел