UIElement.CompositeMode プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
親レイアウトとウィンドウ内の要素の代替合成モードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関係する要素に関連します。
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" />
プロパティ値
列挙体の値。 既定値は ですが Inherit
、「解説」を参照してください。
注釈
設定を解除したままにすると、 の CompositeMode
既定値は になります ElementCompositeMode.Inherits
。 これは、複合モードがビジュアル ツリー内の連続する親から継承されることを意味します。 ただし、XAML ビジュアル ツリーのルートにあるのは、通常はユーザー コードで表されない を hWnd
表す最終的なオブジェクトであり、その有効な CompositeMode
動作は です SourceOver
。 したがって、チェーン内の一部の要素が に特に MinBlend
設定されていない限り、XAML 要素のレンダリング動作はすべて、親ウィンドウから継承されたとして使用 SourceOver
するために継承されます。
を にMinBlend
設定CompositeMode
すると、UI ソースを結合するときに Direct Composition レイヤーで使用される情報であるため、混合 XAML/Microsoft DirectX UI に役立ちます。 この動作は MinBlend
、テキスト オーバーレイなどの状況に適しています。
通常、 の値の MinBlend
設定は SwapChainPanel 要素に最も関連しているため、ホストされるコンテンツはこの動作を取得します。 ただし、テキスト オーバーレイなどの一部のシナリオでは、 Rectangle、 Canvas などの特定の UI 要素に設定することもできます。