UIElement.CompositeMode Eigenschaft

Definition

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

Ein Wert aus der Enumeration. Der Standardwert ist Inherit. Weitere Informationen finden Sie unter Hinweise.

Hinweise

Wenn sie nicht festgelegt bleibt, ist der Standardwert von CompositeModeElementCompositeMode.Inherits. 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 abschließendes Objekt, das den hWnd darstellt, der normalerweise nicht im Benutzercode dargestellt wird, und sein effektives CompositeMode-Verhalten ist SourceOver. Daher erbt das Renderverhalten von XAML-Elementen, es sei denn, ein Element in der Kette ist speziell auf MinBlend festgelegt, um SourceOver wie vom übergeordneten Fenster geerbt zu verwenden.

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

Das Festlegen eines Werts von MinBlend ist in der 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.

Gilt für:

Weitere Informationen