WallpaperManager.SetBitmap 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| SetBitmap(Bitmap, Rect, Boolean, WallpaperManagerFlags) |
setBitmap（Bitmap， Rect， boolean） 的版本，允許呼叫者指定要設定哪些支援的壁紙類別。 |
| SetBitmap(Bitmap, Rect, Boolean) |
將目前系統桌布改成點陣圖，並指定完整影像中哪個子矩形要顯示。 |
| SetBitmap(Bitmap) |
把目前系統的桌布改成點陣圖。 |
SetBitmap(Bitmap, Rect, Boolean, WallpaperManagerFlags)
setBitmap（Bitmap， Rect， boolean） 的版本，允許呼叫者指定要設定哪些支援的壁紙類別。
[Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;Landroid/graphics/Rect;ZI)I", "GetSetBitmap_Landroid_graphics_Bitmap_Landroid_graphics_Rect_ZIHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual int SetBitmap(Android.Graphics.Bitmap? fullImage, Android.Graphics.Rect? visibleCropHint, bool allowBackup, Android.App.WallpaperManagerFlags which);[<Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;Landroid/graphics/Rect;ZI)I", "GetSetBitmap_Landroid_graphics_Bitmap_Landroid_graphics_Rect_ZIHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetBitmap : Android.Graphics.Bitmap * Android.Graphics.Rect * bool * Android.App.WallpaperManagerFlags -> int
override this.SetBitmap : Android.Graphics.Bitmap * Android.Graphics.Rect * bool * Android.App.WallpaperManagerFlags -> int參數
- fullImage
- Bitmap
位圖：提供桌布影像的位圖。
- visibleCropHint
- Rect
Rect：fullImage 中應該作為桌布顯示的矩形子區域。 針對此參數傳送空值，表示根據影像與裝置的長寬比等條件，應盡可能顯示完整影像。
- allowBackup
- Boolean
布林值：如果作業系統允許備份此桌布映像以還原到未來裝置，則為真;否則就是錯誤的。
- which
- WallpaperManagerFlags
int：標示哪些桌布要搭配新影像設定。 價值為0或以下組合：FLAG_SYSTEM FLAG_LOCK
傳回
一個分配給新啟用桌布的整數 ID;或者失敗的機率為零。
- 屬性
備註
setBitmap（Bitmap， Rect， boolean） 的版本，允許呼叫者指定要設定哪些支援的壁紙類別。 需要Manifest.permission.SET_WALLPAPER
另請參閱：
擲出：java.io.IOException
Throws： IllegalArgumentException 如果位圖為空
投擲：IOException
Android 參考資料。android.app.WallpaperManager.setBitmap
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
SetBitmap(Bitmap, Rect, Boolean)
將目前系統桌布改成點陣圖，並指定完整影像中哪個子矩形要顯示。
[Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;Landroid/graphics/Rect;Z)I", "GetSetBitmap_Landroid_graphics_Bitmap_Landroid_graphics_Rect_ZHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual int SetBitmap(Android.Graphics.Bitmap? fullImage, Android.Graphics.Rect? visibleCropHint, bool allowBackup);[<Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;Landroid/graphics/Rect;Z)I", "GetSetBitmap_Landroid_graphics_Bitmap_Landroid_graphics_Rect_ZHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetBitmap : Android.Graphics.Bitmap * Android.Graphics.Rect * bool -> int
override this.SetBitmap : Android.Graphics.Bitmap * Android.Graphics.Rect * bool -> int參數
- fullImage
- Bitmap
位圖：提供桌布影像的位圖。
- visibleCropHint
- Rect
Rect：fullImage 中應該作為桌布顯示的矩形子區域。 針對此參數傳送空值，表示根據影像與裝置的長寬比等條件，應盡可能顯示完整影像。
- allowBackup
- Boolean
布林值：如果作業系統允許備份此桌布映像以還原到未來裝置，則為真;否則就是錯誤的。
傳回
一個分配給新啟用桌布的整數 ID;或者失敗的機率為零。
- 屬性
備註
將目前系統桌布改成點陣圖，並指定完整影像中哪個子矩形要顯示。 作業系統會嘗試將完整影像中指定部分呈現為靜態系統桌布影像。 成功後，意圖Intent.ACTION_WALLPAPER_CHANGED會被廣播。 將 null 作為 visibleHint 參數，等同於傳遞 （0， 0， fullImage.getWidth（）， fullImage.getHeight（））。 此方法要求呼叫者持有權限Manifest.permission.SET_WALLPAPER。 需要Manifest.permission.SET_WALLPAPER
Throws：IOException 如果嘗試將桌布設定為所提供圖片時發生錯誤。
Throws： IllegalArgumentException 如果 visibleCropHint 矩形為空或無效，或位圖為空
Android 參考資料。android.app.WallpaperManager.setBitmap
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
SetBitmap(Bitmap)
把目前系統的桌布改成點陣圖。
[Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;)V", "GetSetBitmap_Landroid_graphics_Bitmap_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual void SetBitmap(Android.Graphics.Bitmap? bitmap);[<Android.Runtime.Register("setBitmap", "(Landroid/graphics/Bitmap;)V", "GetSetBitmap_Landroid_graphics_Bitmap_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetBitmap : Android.Graphics.Bitmap -> unit
override this.SetBitmap : Android.Graphics.Bitmap -> unit參數
- bitmap
- Bitmap
點陣圖：將用作新系統桌布的點陣圖。
- 屬性
備註
把目前系統的桌布改成點陣圖。 給定的點陣圖會被轉換成 PNG 並儲存為桌布。 成功後，意圖Intent.ACTION_WALLPAPER_CHANGED會被廣播。 此方法相當於呼叫 setBitmap（Bitmap，Rect，布林），並將 visibleCrop 矩形為 null，allowBackup 參數為 true。 此方法要求呼叫者持有權限Manifest.permission.SET_WALLPAPER。 需要Manifest.permission.SET_WALLPAPER
Throws：IOException 如果嘗試將桌布設定為所提供圖片時發生錯誤。
Throws： IllegalArgumentException 如果位圖為空
Android 參考資料。android.app.WallpaperManager.setBitmap
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。