UIElement.CompositeMode Свойство

Определение

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

Windows.UI.Xaml

Возвращает или задает свойство, объявляющее альтернативные режимы композиции и наложения для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX.

public:
 property ElementCompositeMode CompositeMode { ElementCompositeMode get(); void set(ElementCompositeMode value); };

ElementCompositeMode CompositeMode();

void CompositeMode(ElementCompositeMode value);

public ElementCompositeMode CompositeMode { get; set; }

var elementCompositeMode = uIElement.compositeMode;
uIElement.compositeMode = elementCompositeMode;

Public Property CompositeMode As ElementCompositeMode

<uiElement CompositeMode="elementCompositeModeMemberName" />

Значение свойства

ElementCompositeMode

Значение перечисления. Значение по умолчанию — Наследовать, но см. раздел Примечания.

Комментарии

Если этот параметр не задан, значение по умолчанию CompositeMode — ElementCompositeMode.Inherits. Это означает, что составной режим наследует от последовательных родительских элементов в визуальном дереве. Однако в корне визуального дерева XAML находится конечный объект , представляющий hWnd , который обычно не представлен в пользовательском коде, и его эффективным поведением CompositeMode является SourceOver. Таким образом, если для какого-либо элемента в цепочке не задано специальное значение MinBlend, поведение отрисовки всех элементов XAML наследуется для использования SourceOver в качестве наследуемого от родительского окна.

Установка параметра CompositeMode в Значение MinBlend полезна для смешанного пользовательского интерфейса XAML или Microsoft DirectX, так как это сведения, используемые слоем прямой композиции при объединении источников пользовательского интерфейса. Поведение MinBlend может быть лучше в таких ситуациях, как наложения текста.

Установка значения MinBlend обычно наиболее актуальна для элемента SwapChainPanel , поэтому размещенное содержимое получает такое поведение. Но для некоторых сценариев, таких как наложение текста, его также можно задать для определенных элементов пользовательского интерфейса, таких как Rectangle, Canvas и т. д.

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

• SwapChainBackgroundPanel
• Взаимодействие DirectX и XAML