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


BackdropMaterial Класс

Определение

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

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

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>
Наследование
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 (используйте ветвь main для WinUI 3 и winui2 ветви для WinUI 2).

Комментарии

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

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

Осторожность

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

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

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

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

Присоединенное свойство Описание
ApplyToRootOrPageBackground Применяет фоновый материал к корневому или фоновому фону содержимого XAML. Свойство ApplyToRootOrPageBackground является логическим значением, которое указывает, применяется ли фоновая материала.

Свойства

ApplyToRootOrPageBackgroundProperty

Определяет присоединенное свойство XAML BackdropMaterial.ApplyToRootOrPageBackground.

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

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

ApplyToRootOrPageBackground

Применяет фоновый материал к корневому или фоновому фону содержимого XAML.

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

Методы

GetApplyToRootOrPageBackground(Control)

Возвращает значение присоединенного свойства XAML BackdropMaterial.ApplyToRootOrPageBackground для целевого элемента.

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

SetApplyToRootOrPageBackground(Control, Boolean)

Задает значение присоединенного свойства XAML BackdropMaterial.ApplyToRootOrPageBackground для целевого элемента.

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

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

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