UIElement.CompositeMode Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и наложения для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе 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" />
Значение свойства
Значение перечисления. Значение по умолчанию — Наследовать, но см. раздел Примечания.
Комментарии
Если этот параметр не задан, значение по умолчанию CompositeMode — ElementCompositeMode.Inherits. Это означает, что составной режим наследует от последовательных родительских элементов в визуальном дереве. Однако в корне визуального дерева XAML находится конечный объект , представляющий hWnd , который обычно не представлен в пользовательском коде, и его эффективным поведением CompositeMode является SourceOver. Таким образом, если для какого-либо элемента в цепочке не задано специальное значение MinBlend, поведение отрисовки всех элементов XAML наследуется для использования SourceOver в качестве наследуемого от родительского окна.
Установка параметра CompositeMode в Значение MinBlend полезна для смешанного пользовательского интерфейса XAML или Microsoft DirectX, так как это сведения, используемые слоем прямой композиции при объединении источников пользовательского интерфейса. Поведение MinBlend может быть лучше в таких ситуациях, как наложения текста.
Установка значения MinBlend обычно наиболее актуальна для элемента SwapChainPanel , поэтому размещенное содержимое получает такое поведение. Но для некоторых сценариев, таких как наложение текста, его также можно задать для определенных элементов пользовательского интерфейса, таких как Rectangle, Canvas и т. д.