WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
<strong> Important note: </strong>
<ul>
<li>Up to version S, this method requires the
android.Manifest.permission#READ_EXTERNAL_STORAGE
permission.
[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
Parameters
- which
- WallpaperManagerFlags
The wallpaper whose image file is to be retrieved. Must be a single
defined kind of wallpaper, either #FLAG_SYSTEM
or
#FLAG_LOCK
.
Returns
An open, readable file descriptor to the requested wallpaper image file;
or null
if no such wallpaper is configured or if the calling app does
not have permission to read the current wallpaper.
- Attributes
Remarks
<strong> Important note: </strong> <ul> <li>Up to version S, this method requires the android.Manifest.permission#READ_EXTERNAL_STORAGE
permission.</li> <li>Starting in T, directly accessing the wallpaper is not possible anymore, instead the default system wallpaper is returned (some versions of T may throw a SecurityException
).</li> <li>From version U, this method should not be used and will always throw a
Java documentation for android.app.WallpaperManager.getWallpaperFile(int)
.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.