UIElement.CompositeMode Propriedade

Definição

Namespace:

Windows.UI.Xaml

Obtém ou define uma propriedade que declara modos alternativos de composição e mesclagem para o elemento em seu layout pai e janela. Isso é relevante para elementos envolvidos em uma interface do usuário XAML/Microsoft DirectX mista.

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

Valor da propriedade

ElementCompositeMode

Um valor da enumeração. O padrão é Herdar, mas consulte Comentários.

Comentários

Se não for definido, o valor padrão de CompositeMode será ElementCompositeMode.Inherits. Isso significa que o modo composto herda de pais sucessivos na árvore visual. No entanto, na raiz de uma árvore visual XAML está um objeto final que representa o hWnd que normalmente não é representado no código do usuário, e seu comportamento de CompositeMode eficaz é SourceOver. Portanto, a menos que algum elemento na cadeia seja definido especificamente como MinBlend, o comportamento de renderização de elementos XAML herdará para usar SourceOver conforme herdado da janela pai.

Definir CompositeMode como MinBlend é útil para uma interface do usuário XAML/Microsoft DirectX mista porque são informações usadas pela camada de Composição Direta quando combina as fontes de interface do usuário. O comportamento de MinBlend pode ser melhor para situações como sobreposições de texto.

A definição de um valor de MinBlend normalmente é mais relevante para um elemento SwapChainPanel , de modo que o conteúdo hospedado obtenha esse comportamento. Mas para alguns cenários, como sobreposições de texto, ele também pode ser definido em elementos específicos da interface do usuário, como Rectangle, Canvas e assim por diante.

Confira também

• SwapChainBackgroundPanel
• Interoperabilidade entre DirectX e XAML