From 41dc83bd578c12a481a42357ca51a8cab82ce54c Mon Sep 17 00:00:00 2001 From: Christopher Tate Date: Fri, 15 Jul 2016 15:59:23 -0700 Subject: [PATCH] Document that WallpaperManager.getDrawable() can return null Bug 30164766 Change-Id: Idc03a41ea3fab3772de4f24551765dff78eb6d7f --- core/java/android/app/WallpaperManager.java | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/core/java/android/app/WallpaperManager.java b/core/java/android/app/WallpaperManager.java index 53da4e32eb8ab..2ee92a6ec778a 100644 --- a/core/java/android/app/WallpaperManager.java +++ b/core/java/android/app/WallpaperManager.java @@ -417,8 +417,14 @@ public class WallpaperManager { * This is returned as an * abstract Drawable that you can install in a View to display whatever * wallpaper the user has currently set. + *

+ * This method can return null if there is no system wallpaper available, if + * wallpapers are not supported in the current user, or if the calling app is not + * permitted to access the system wallpaper. * - * @return Returns a Drawable object that will draw the wallpaper. + * @return Returns a Drawable object that will draw the system wallpaper, + * or {@code null} if no system wallpaper exists or if the calling application + * is not able to access the wallpaper. */ public Drawable getDrawable() { Bitmap bm = sGlobals.peekWallpaperBitmap(mContext, true, FLAG_SYSTEM);