WallpaperManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供系統桌布的存取權限。
[Android.Runtime.Register("android/app/WallpaperManager", DoNotGenerateAcw=true)]
public class WallpaperManager : Java.Lang.Object[<Android.Runtime.Register("android/app/WallpaperManager", DoNotGenerateAcw=true)>]
type WallpaperManager = class
inherit Object- 繼承
- 屬性
備註
提供系統桌布的存取權限。 使用 PasswordManager，你可以取得當前的壁紙、設定壁紙尺寸、設定壁紙等等。 應用程式可透過呼叫 isWallpaperSupported（） 查詢目前使用者是否支援桌布，並透過呼叫 isSetWallpaperAllowed（）來檢查是否允許設定桌布。 任何新增到 WallpaperManager 的公開 API 應該會在 ERROR（DisabledWallpaperManager/android.app.DisabledWallpaperManager DisabledWallpaperManager） 中有一個對應的存根。
Android 參考資料。android.app.WallpaperManager
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| WallpaperManager(IntPtr, JniHandleOwnership) |
初始化現有 Java 原生介面物件的受管理表示。 |
欄位
| 名稱 | Description |
|---|---|
| ActionChangeLiveWallpaper |
直接啟動即時桌布預覽，讓使用者能立即確認切換到特定的動態桌布。 |
| ActionCropAndSetWallpaper |
活動動作：顯示選擇桌布的設定。 |
| ActionLiveWallpaperChooser |
啟動一個活動讓使用者選擇當前的全球動態桌布。 |
| CommandDrop |
sendWallpaperCommand（IBinder， String， int， int， int， Bundle）指令：當使用者將物件放入主機區域時，由桌布主機回報。 |
| CommandSecondaryTap |
sendWallpaperCommand（IBinder， String， int， int， int， Bundle）指令：當使用者在空區域放下一個指標時，桌布主機會回報（未執行主機內的動作）。 |
| CommandTap |
sendWallpaperCommand（IBinder， String， int， int， int， Bundle）：當使用者點擊空區（未執行主機操作）時，桌布主機會回報。 |
| ExtraLiveWallpaperComponent |
ACTION_CHANGE_LIVE_WALLPAPER中還需要額外說明動態桌布的元件名稱，該桌布應該以預覽方式顯示，供使用者確認。 |
| FlagLock |
已淘汰.
標記：設定或取得鎖定畫面專屬的桌布。 |
| FlagSystem |
已淘汰.
標記：設定或取回一般系統桌布。 |
| WallpaperPreviewMetaData |
為回應Intent.ACTION_SET_WALLPAPER的活動提供清單條目，允許他們提供與此動作相關的自訂大型圖示。 |
屬性
| 名稱 | Description |
|---|---|
| BuiltInDrawable |
取得內建靜態系統壁紙的繪圖資料。 |
| Class |
回傳此 |
| DesiredMinimumHeight |
回傳壁紙所需的最低高度。 |
| DesiredMinimumWidth |
回傳壁紙所需的最小寬度。 |
| Drawable |
重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。 |
| FastDrawable |
重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsSetWallpaperAllowed |
回傳呼叫套件是否被允許為呼叫使用者設定桌布。 |
| IsWallpaperSupported |
回傳呼叫使用者是否支援桌布。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| JniPeerMembers |
提供 Android.App.WallpaperManager 的 JNI 綁定基礎設施。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
提供 Android.App.WallpaperManager 的 JNI 綁定基礎設施。 |
| ThresholdType |
提供 Android.App.WallpaperManager 的 JNI 綁定基礎設施。 |
| WallpaperInfo |
如果主畫面桌布目前是活頁紙元件，則會回傳該主畫面桌布的資訊。 |
方法
| 名稱 | Description |
|---|---|
| AddOnColorsChangedListener(WallpaperManager+IOnColorsChangedListener, Handler) |
註冊監聽者以接收桌布顏色變化的通知。 |
| Clear() |
移除目前已設定的系統桌布，恢復成系統內建的桌布。 |
| Clear(WallpaperManagerFlags) |
移除一個或多個目前設定的桌布，並恢復系統預設顯示。 |
| ClearWallpaper() |
相當於 clear（）。 |
| ClearWallpaperOffsets(IBinder) |
透過 setWallpaperOffsets（IBinder， float， float） 清除先前與此視窗相關的偏移量。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| Equals(Object) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| ForgetLoadedWallpaper() |
移除所有內部指向最後載入壁紙的參考。 |
| GetBuiltInDrawable(Int32, Int32, Boolean, Single, Single, WallpaperManagerFlags) |
回傳指定類型內建靜態壁紙的可繪製圖。 |
| GetBuiltInDrawable(Int32, Int32, Boolean, Single, Single) |
回傳系統內建靜態桌布的可繪圖檔。 |
| GetBuiltInDrawable(WallpaperManagerFlags) |
取得指定內建靜態系統桌布的可繪圖物件。 |
| GetCropAndSetWallpaperIntent(Uri) |
會有一個意圖，會啟動一個活動，裁切給定的圖片並設定裝置的桌布。 |
| GetDrawable(WallpaperManagerFlags) |
重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。 |
| GetFastDrawable(WallpaperManagerFlags) |
重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetInstance(Context) |
取得與該上下文相關的 WallpaperManager。 |
| GetWallpaperColors(Int32) |
選擇壁紙的原色。 |
| GetWallpaperFile(WallpaperManagerFlags) |
重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。 |
| GetWallpaperId(WallpaperManagerFlags) |
取得目前該類型壁紙的識別碼。 |
| GetWallpaperInfo(WallpaperManagerFlags) |
如果該桌布目前的桌布是活桌布元件，則會回傳該指定桌布的資訊。 |
| HasResourceWallpaper(Int32) |
回傳是否有使用者目前設定使用該資源 ID 的桌布。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| PeekDrawable() |
重要注意：在 Android 12 之前，此方法需要 Manifest.permission.READ_EXTERNAL_STORAGE 授權。 |
| PeekDrawable(WallpaperManagerFlags) |
重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。 |
| PeekFastDrawable() |
重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。 |
| PeekFastDrawable(WallpaperManagerFlags) |
重要提醒：只有有Manifest.permission.MANAGE_EXTERNAL_STORAGE的應用程式才應該使用這種方法。 |
| RemoveOnColorsChangedListener(WallpaperManager+IOnColorsChangedListener) |
別再聽色彩更新了。 |
| SendWallpaperCommand(IBinder, String, Int32, Int32, Int32, Bundle) |
對目前正在播放的桌布發送任意指令。 |
| SetBitmap(Bitmap, Rect, Boolean, WallpaperManagerFlags) |
setBitmap（Bitmap， Rect， boolean） 的版本，允許呼叫者指定要設定哪些支援的壁紙類別。 |
| SetBitmap(Bitmap, Rect, Boolean) |
將目前系統桌布改成點陣圖，並指定完整影像中哪個子矩形要顯示。 |
| SetBitmap(Bitmap) |
把目前系統的桌布改成點陣圖。 |
| SetDisplayPadding(Rect) |
指定桌布在顯示器外應該有額外的填充物。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| SetResource(Int32, WallpaperManagerFlags) |
這個版本 |
| SetResource(Int32) |
將當前系統桌布改成該資源中的點陣圖。 |
| SetStream(Stream, Rect, Boolean, WallpaperManagerFlags) |
setStream（InputStream， Rect， boolean） 的版本，允許呼叫者指定要設定哪些支援的壁紙類別。 |
| SetStream(Stream, Rect, Boolean) |
將目前系統的桌布改成特定的位元組串流，並指定要顯示完整影像哪個子矩形的提示。 |
| SetStream(Stream) |
把目前系統的桌布改成特定的位元組串流。 |
| SetWallpaperOffsets(IBinder, Single, Single) |
在該桌布在視窗後方可見時，將目前桌布的顯示位置設為任何較大空間。 |
| SetWallpaperOffsetSteps(Single, Single) |
對於使用多個虛擬畫面顯示桌布的應用程式，請指定虛擬畫面之間的步長。 |
| SuggestDesiredDimensions(Int32, Int32) |
僅限於目前的家庭應用程式使用，以指定想要使用的壁紙尺寸。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
事件
| 名稱 | Description |
|---|---|
| ColorsChanged | |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
提供系統桌布的存取權限。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
提供系統桌布的存取權限。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |