Sprache

UIElement.CompositeMode Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer Eigenschaft, die alternative Kompositions- und Blendungsmodi für das Element im übergeordneten Layout und Fenster deklariert. Dies ist für Elemente relevant, die an einem gemischten XAML/Microsoft DirectX-UI 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 der Aufzählung. Der Standardwert ist Inherit, aber siehe Hinweise.

Hinweise

Wenn sie nicht festgelegt ist, lautet ElementCompositeMode.Inheritsder Standardwert von CompositeMode . Dies bedeutet, dass der zusammengesetzte Modus von aufeinander folgenden übergeordneten Elementen in der visuellen Struktur erbt. Im Stammverzeichnis einer visuellen XAML-Struktur handelt es sich jedoch um ein endgültiges Objekt, das das hWnd normalerweise nicht im Benutzercode dargestellte Objekt darstellt, und sein effektives CompositeMode Verhalten ist SourceOver. Es sei denn, einige Elemente in der Kette werden speziell auf MinBlenddas Renderverhalten von XAML-Elementen festgelegt, die alle erben, um sie als geerbt vom übergeordneten Fenster zu verwenden SourceOver .

MinBlend Die Einstellung CompositeMode ist nützlich für eine gemischte XAML-/Microsoft DirectX-Benutzeroberfläche, 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 wie Textüberlagerungen kann sie jedoch auch für bestimmte UI-Elemente wie Rectangle, Canvas usw. festgelegt werden.

Gilt für:

Weitere Informationen