WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
<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を返します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。