WallpaperManager.PeekDrawable 方法

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
PeekDrawable()	重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。
PeekDrawable(WallpaperManagerFlags)	重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。

PeekDrawable()

重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。

[Android.Runtime.Register("peekDrawable", "()Landroid/graphics/drawable/Drawable;", "GetPeekDrawableHandler")]
public virtual Android.Graphics.Drawables.Drawable? PeekDrawable();

[<Android.Runtime.Register("peekDrawable", "()Landroid/graphics/drawable/Drawable;", "GetPeekDrawableHandler")>]
abstract member PeekDrawable : unit -> Android.Graphics.Drawables.Drawable
override this.PeekDrawable : unit -> Android.Graphics.Drawables.Drawable

傳回

Drawable

一個可繪製的桌布物件。這個值可能是 Null。

屬性: RegisterAttribute

備註

重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。從 Android 13 開始，無法直接存取桌布，取而代之的是回傳預設系統桌布（某些版本的 Android 13 可能會拋出 SecurityException）。從 Android 14 開始，此方法不應使用，且會一直拋出 SecurityException。有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式在所有版本中仍可存取真實桌布。相當於 getDrawable（）。

另請參閱：

拋出：如註解所述的 SecurityException

Android 參考資料。android.app.WallpaperManager.peekDrawable

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

PeekDrawable(WallpaperManagerFlags)

重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。

[Android.Runtime.Register("peekDrawable", "(I)Landroid/graphics/drawable/Drawable;", "GetPeekDrawable_IHandler", ApiSince=34)]
public virtual Android.Graphics.Drawables.Drawable? PeekDrawable(Android.App.WallpaperManagerFlags which);

[<Android.Runtime.Register("peekDrawable", "(I)Landroid/graphics/drawable/Drawable;", "GetPeekDrawable_IHandler", ApiSince=34)>]
abstract member PeekDrawable : Android.App.WallpaperManagerFlags -> Android.Graphics.Drawables.Drawable
override this.PeekDrawable : Android.App.WallpaperManagerFlags -> Android.Graphics.Drawables.Drawable

參數

which: WallpaperManagerFlags

int：有效壁紙類型的 FLAG_* 識別碼。如果請求無效桌布，會拋出 IllegalArgumentException。價值為0或以下組合：FLAG_SYSTEM FLAG_LOCK

傳回