UIElement.Opacity プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー インターフェイス (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, setPublic Property Opacity As 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 |
なし |
| 製品 | バージョン |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |