語言

WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) 方法

定義

命名空間:
Android.App
組件:
Mono.Android.dll

<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是 。

傳回

ParcelFileDescriptor

一個開放且可讀的檔案描述符，用於請求的桌布影像檔案;或者 null 如果沒有設定此類桌布，或呼叫應用程式沒有權限讀取目前的桌布。

屬性
RegisterAttribute

備註

<strong> 重要提示：</strong><ul<>li>在 Android 12 之前，此方法需要取得android.Manifest.permission#READ_EXTERNAL_STORAGE許可。</li><li>從 Android 13 開始，無法直接存取桌布，取而代之的是回傳預設系統桌布（某些版本的 Android 13 可能會拋出 ）。SecurityException</li><li>從 Android 14 開始，此方法不應使用，且會一直拋出 SecurityException。</android.Manifest.permission#MANAGE_EXTERNAL_STORAGEli><li 的>應用程式在所有版本上仍可存取真實桌布。 </li>/ul><br<>

取得一個開放且可讀的檔案描述符，來描述給給的桌布圖片檔案。 呼叫者負責在完成檔案擷取後關閉檔案描述符。

若未為該使用者設定鎖定專用桌布，則此方法會在請求#FLAG_LOCK時回傳null，而非回傳系統桌布的影像檔。

Java 文件 android.app.WallpaperManager.getWallpaperFile(int)。

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

適用於