UIElement.CompositeMode Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft eine Eigenschaft ab, die alternative Kompositions- und Mischmodi für das Element im übergeordneten Layout und Fenster deklariert, oder legt sie fest. Dies ist für Elemente relevant, die an einer gemischten XAML-/Microsoft DirectX-Benutzeroberfläche beteiligt sind.

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" />

Eigenschaftswert

ElementCompositeMode

Ein Wert aus der Enumeration. Der Standardwert ist Inherit, aber siehe Hinweise.

Hinweise

Wenn sie nicht festgelegt bleibt, ist ElementCompositeMode.Inheritsder Standardwert von CompositeMode . Dies bedeutet, dass der zusammengesetzte Modus von aufeinander folgenden übergeordneten Elementen in der visuellen Struktur erbt. Im Stamm einer visuellen XAML-Struktur befindet sich jedoch ein endgültiges Objekt, das das in der hWnd Regel nicht im Benutzercode dargestellt wird, und sein effektives CompositeMode Verhalten ist SourceOver. Daher erbt das Renderverhalten von XAML-Elementen, sofern nicht ein Element in der Kette speziell auf MinBlendfestgelegt ist, so dass SourceOver es vom übergeordneten Fenster geerbt wird.

Die Einstellung CompositeMode auf MinBlend ist für eine gemischte XAML-/Microsoft DirectX-Benutzeroberfläche nützlich, da es sich um Informationen handelt, die von der Direkten Kompositionsebene verwendet werden, wenn sie die UI-Quellen kombiniert. Das MinBlend Verhalten kann für Situationen wie Textüberlagerungen besser sein.

Das Festlegen des Werts von ist in der MinBlend Regel für ein SwapChainPanel-Element am relevantesten, sodass der gehostete Inhalt dieses Verhalten erhält. Für einige Szenarien, z. B. Textüberlagerungen, kann sie jedoch auch für bestimmte Benutzeroberflächenelemente wie Rechteck, Canvas usw. festgelegt werden.

Weitere Informationen

• SwapChainBackgroundPanel
• Interoperabilität von DirectX und XAML