UIElement.CompositeMode 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个属性,该属性为其父布局和窗口中的元素声明备用组合和混合模式。 这与混合 XAML/Microsoft DirectX UI 中涉及的元素相关。
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 。
将 CompositeMode 设置为 MinBlend 对于混合 XAML/Microsoft DirectX UI 非常有用,因为它是直接合成层在合并 UI 源时使用的信息。 对于文本覆盖等情况, MinBlend 行为可能更好。
设置 MinBlend 值通常与 SwapChainPanel 元素最相关,以便托管内容获取此行为。 但对于某些方案(如文本覆盖),也可以在特定 UI 元素(如 Rectangle、 Canvas 等)上设置它。