UIElement.HighContrastAdjustment プロパティ

定義

ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。

public:
 property ElementHighContrastAdjustment HighContrastAdjustment { ElementHighContrastAdjustment get(); void set(ElementHighContrastAdjustment value); };
ElementHighContrastAdjustment HighContrastAdjustment();

void HighContrastAdjustment(ElementHighContrastAdjustment value);
public ElementHighContrastAdjustment HighContrastAdjustment { get; set; }
var elementHighContrastAdjustment = uIElement.highContrastAdjustment;
uIElement.highContrastAdjustment = elementHighContrastAdjustment;
Public Property HighContrastAdjustment As ElementHighContrastAdjustment

プロパティ値

ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す 列挙の値。 既定値は Application です

Windows の要件

デバイス ファミリ
Windows 10 Creators Update (10.0.15063.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v4.0 で導入)

注釈

プロパティの値が継承されます。 [アプリケーション] に設定すると、調整によって ApplicationHighContrastAdjustment プロパティに設定されている内容がミラーされます。 アプリケーションHighContrastAdjustment プロパティを None に設定すると、アプリケーション内のすべての UI で有効に無効になります。 値を Auto に明示的に設定することで、UIElement に対して選択的に有効にすることができます。
[自動] に設定すると、ハイ コントラスト テーマが有効になっている間、フレームワークは XAML のテキスト要素に次の調整を自動的に適用します。

  • テキストの前景色は無視されます。 IsEnabled = "False" の親コントロールの場合、システムのハイ コントラスト テキストの色または無効な色を使用して、テキストに色が付きます。
  • 不透明な四角形は、高コントラスト比を適用するためにテキストのすぐ後ろにレンダリングされます。
  • Opacity の 0 以外の値は無視されます。 要素とその子は、不透明度が 1.0 であるかのように表示されます。

UIElement で HighContrastAdjustment = None を設定し、その子孫の 1 つに HighContrastAdjustment = Auto を設定できます。 ただし、いずれかの先祖に不透明度が適用されている場合、フレームワークでは子孫が完全に不透明になることは保証されません。

適用対象