UIElement.Opacity プロパティ

定義

ユーザー インターフェイス (UI) でレンダリングされるときに全体 UIElement に適用される不透明度係数を取得または設定します。 これは依存関係プロパティです。

public:
 property double Opacity { double get(); void set(double value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Opacity { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Opacity : double with get, set
Public Property Opacity As Double

プロパティ値

Double

不透明度率。 既定の不透明度は 1.0 です。 予期される値は 0 0 ~ 1.0 です。

属性

注釈

1.0 の既定値は、クラスのこの依存関係プロパティ UIElement の初期メタデータによって提供される既定値です。 他の派生クラスでは、クラス コンストラクター内からメタデータをオーバーライドすることで、この既定値が変更される可能性があります。

要素も表示されない限り、実際のOpacityレイアウトには適用されません (IsVisible次の値)。true

Opacity は、要素ツリーの親要素から子要素に適用されますが、入れ子になった不透明度設定の表示効果は、個々の子要素のプロパティ値には示されません。 たとえば、リストの不透明度が 50% (0.5) で、リスト アイテムの 1 つが独自の不透明度を 20% (0.2) に設定している場合、そのリスト アイテムのネット表示不透明度は 10% (0.1) であるかのようにレンダリングされますが、クエリを実行してもリスト アイテム Opacity プロパティのプロパティ値は 0.2 になります。

宣言または評価された不透明度が 0 の場合でも、要素は入力イベントとコマンドに参加し、フォーカス可能な可能性があります。 この側面は便利です。たとえば、不透明ゼロ オブジェクト (図形など) を使用して、基になるオブジェクトを透明な要素でマスクできます。 その後、opacity-zero オブジェクトは、基になる領域のすべての入力イベント処理を処理できます。 ただし、 Background オブジェクトまたは Fill 図形の値は、値に設定する必要があります。それ以外の場合は Transparentヒット テストが有効ではなく、イベントは受信されません。

依存プロパティ情報

識別子フィールド OpacityProperty
メタデータのプロパティが次に設定されている true なし

適用対象

こちらもご覧ください