Language

WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) メソッド

定義

<strong> 重要な注意事項: </strong><ul><li> Android 12 まで、このメソッドには android.Manifest.permission#READ_EXTERNAL_STORAGE アクセス許可が必要です。

[Android.Runtime.Register("getWallpaperFile", "(I)Landroid/os/ParcelFileDescriptor;", "GetGetWallpaperFile_IHandler", ApiSince=24)]
public virtual Android.OS.ParcelFileDescriptor? GetWallpaperFile(Android.App.WallpaperManagerFlags which);
[<Android.Runtime.Register("getWallpaperFile", "(I)Landroid/os/ParcelFileDescriptor;", "GetGetWallpaperFile_IHandler", ApiSince=24)>]
abstract member GetWallpaperFile : Android.App.WallpaperManagerFlags -> Android.OS.ParcelFileDescriptor
override this.GetWallpaperFile : Android.App.WallpaperManagerFlags -> Android.OS.ParcelFileDescriptor

パラメーター

which
WallpaperManagerFlags

イメージ ファイルを取得する壁紙。 #FLAG_SYSTEMまたは#FLAG_LOCKのいずれかの壁紙の単一の定義された種類である必要があります。

返品

要求された壁紙イメージファイルへのオープンで読み取り可能なファイル記述子。または、そのような壁紙が構成されていない場合、または呼び出し元のアプリが現在の壁紙を読み取るアクセス許可を持っていない場合に null します。

属性

注釈

<strong> 重要な注意事項: </strong><ul><li> Android 12 まで、このメソッドには android.Manifest.permission#READ_EXTERNAL_STORAGE のアクセス許可が必要です。</li><li>Android 13で直接壁紙にアクセスすることはできなくなりました。代わりに、既定のシステム壁紙が返されます(Android 13の一部のバージョンでは SecurityExceptionがスローされる可能性があります)。</li><li> Android 14 では、このメソッドを使用しないでください。常に SecurityException.</li><li>android.Manifest.permission#MANAGE_EXTERNAL_STORAGE を持つアプリは、引き続きすべてのバージョンで実際の壁紙にアクセスすることができます。 </li></ul><br>

指定された壁紙イメージファイルに対して、開いて読み取り可能なファイル記述子を取得します。 呼び出し元は、ファイルの取り込みの完了時にファイル記述子を閉じる役割を担います。

特定のユーザーに対してロック固有の壁紙が構成されていない場合、このメソッドはシステム壁紙のイメージ ファイルを返すのではなく、#FLAG_LOCKを要求するときにnullを返します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象