BackdropMaterial Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Вспомогательный класс для применения материала фона к корню содержимого XAML.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

public ref class BackdropMaterial : DependencyObject

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackdropMaterial : DependencyObject

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class BackdropMaterial : DependencyObject

Public Class BackdropMaterial
Inherits DependencyObject

<Page muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    pageContent
</Page>
-or-
<Frame muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    appContent
</Frame>

Наследование

DependencyObject

BackdropMaterial

Атрибуты

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Mica.

Приложения из коллекции WinUI 3 и коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 3 и WinUI 2.

Если они уже установлены, откройте их с помощью следующих ссылок: коллекция WinUI 3 или коллекция WinUI 2.

Если они не установлены, вы можете скачать коллекцию WinUI 3 и коллекцию WinUI 2 из Microsoft Store.

Исходный код можно также получить из GitHub (используйте главную ветвь для WinUI 3 и ветвь winui2 для WinUI 2).

Комментарии

Материал фона — это материал , созданный из источника пикселей, взятых из области за содержимым XAML.

Класс BackdropMaterial позволяет применить материал фона Mica к целевому объекту композиции приложения. Она автоматически поддерживает изменения темы, версии нижнего уровня и состояние устройства, устанавливая при необходимости кисть XAML нейтрального цвета.

Внимание!

При применении материала фона не следует также задавать Background свойство для содержимого пользовательского интерфейса. Фон должен быть прозрачным, чтобы материал фона отображалось до конца.

Присоединенные свойства XAML

BackdropMaterial — это класс службы узла для присоединенного ApplyToRootOrPageBackgroundсвойства XAML.

Для поддержки доступа обработчика XAML к присоединенным свойствам, а также для предоставления коду эквивалентных операций получения и задания , каждое присоединенное свойство XAML имеет пару методов доступа Get и Set. Другой способ получить или задать значение в коде — использовать систему свойств зависимостей, вызывая метод GetValue или SetValue и передавая поле идентификатора в качестве идентификатора свойства зависимостей.

Присоединенное свойство

Описание

ApplyToRootOrPageBackground

Применяет материал фона к корню или фону содержимого XAML. Тип: Bool Поле идентификатора: ApplyToRootOrPageBackgroundProperty Методы доступа: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) Свойство ApplyToRootOrPageBackground является логическим значением, которое указывает, применяется ли материал фона.

Свойства

ApplyToRootOrPageBackgroundProperty

Идентифицирует присоединенное BackdropMaterial.ApplyToRootOrPageBackground свойство XAML. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Присоединенные свойства

ApplyToRootOrPageBackground

Применяет материал фона к корню или фону содержимого XAML. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Методы

GetApplyToRootOrPageBackground(Control)	Возвращает значение присоединенного BackdropMaterial.ApplyToRootOrPageBackground свойства XAML для целевого элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SetApplyToRootOrPageBackground(Control, Boolean)	Задает значение присоединенного BackdropMaterial.ApplyToRootOrPageBackground свойства XAML для целевого элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

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

• Mica