UIElement.CompositeMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.