AcrylicBrush Класс

Ссылка

Определение

Пространство имен:: Windows.UI.Xaml.Media

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

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

Эквивалентный 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

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

Чтобы добавить акриловую кисть, определите три ресурса для темных, светлых и высококонтрастных тем. Обратите внимание, что в высокой контрастности рекомендуется использовать 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)

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

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

Обзор акриловых материалов

Поделиться через

AcrylicBrush Класс

Определение

Требования к Windows

Примеры

Комментарии

Журнал версий

Конструкторы

Свойства

Методы

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

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

Обратная связь

Дополнительные ресурсы