Window.SetBackgroundBlurRadius(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ウィンドウの境界内でウィンドウの背後にある画面をぼかします。
[Android.Runtime.Register("setBackgroundBlurRadius", "(I)V", "GetSetBackgroundBlurRadius_IHandler", ApiSince=31)]
public virtual void SetBackgroundBlurRadius(int blurRadius);
[<Android.Runtime.Register("setBackgroundBlurRadius", "(I)V", "GetSetBackgroundBlurRadius_IHandler", ApiSince=31)>]
abstract member SetBackgroundBlurRadius : int -> unit
override this.SetBackgroundBlurRadius : int -> unit
パラメーター
- blurRadius
- Int32
ウィンドウの背景のぼかしに使用するぼかしの半径 (ピクセル単位)
- 属性
注釈
ウィンドウの境界内でウィンドウの背後にある画面をぼかします。
ぼかしの密度は、ぼかし半径によって設定されます。 半径は隣接する領域のサイズを定義し、そこからピクセルを平均化して各ピクセルの最終的な色を形成します。 この操作は、ガウスぼかしに近くなります。 半径 0 は、ぼかしがないことを意味します。 半径が大きいほど、ぼかしが濃くなります。
描画可能なウィンドウの背景は、ぼかし領域の上に描画されます。 ぼかし領域の境界と丸い角は、描画可能な背景の境界を模倣します。
ぼかし領域を表示するには、ウィンドウを半透明にする必要があります ( android.R.attr#windowIsTranslucent参照) と浮動 ( android.R.attr#windowIsFloating参照)。
WindowManager.LayoutParams#setBlurBehindRadiusとの違いに注意してください。ウィンドウの背後にある画面全体がぼかされます。 背景のぼかしは、ウィンドウの境界内でのみ画面の背後をぼかします。
GPU の制限により、一部のデバイスではウィンドウ間ぼかしがサポートされない場合があります。 また、バッテリ節約モード中、マルチメディアトンネリングが使用されている場合、または最小限の後処理が要求された場合など、実行時に無効にすることもできます。 このような状況では、ぼかしが計算または描画されず、ウィンドウの背景が透明になります。 これを回避するために、アプリでは、そのテーマをぼかしを使用しないテーマに変更することが必要な場合があります。 ウィンドウ間ぼかしの有効化/無効化されたイベントをリッスンするには、 WindowManager#addCrossWindowBlurEnabledListenerを使用します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。