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