WallpaperManager.SetStream 方法

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

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

多載

名稱	Description
SetStream(Stream)	把目前系統的桌布改成特定的位元組串流。
SetStream(Stream, Rect, Boolean)	將目前系統的桌布改成特定的位元組串流，並指定要顯示完整影像哪個子矩形的提示。
SetStream(Stream, Rect, Boolean, WallpaperManagerFlags)	setStream（InputStream， Rect， boolean）的版本，允許呼叫者指定要設定哪些支援的壁紙類別。

SetStream(Stream)

把目前系統的桌布改成特定的位元組串流。

[Android.Runtime.Register("setStream", "(Ljava/io/InputStream;)V", "GetSetStream_Ljava_io_InputStream_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual void SetStream(System.IO.Stream? bitmapData);

[<Android.Runtime.Register("setStream", "(Ljava/io/InputStream;)V", "GetSetStream_Ljava_io_InputStream_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetStream : System.IO.Stream -> unit
override this.SetStream : System.IO.Stream -> unit

參數

bitmapData: Stream

InputStream：包含原始資料，需安裝為桌布的串流。這些資料可以是 BitmapRegionDecoder 處理的任何格式。

屬性: RegisterAttribute RequiresPermissionAttribute

備註

把目前系統的桌布改成特定的位元組串流。 Input Stream 會被複製到持久儲存，現在會被用作桌布。目前必須是 JPEG 或 PNG 圖片。成功後，意圖Intent.ACTION_WALLPAPER_CHANGED會被廣播。此方法相當於呼叫 setStream（InputStream，Rect，布林），並將 visibleCrop 矩形傳送為 null，allowBackup 參數為 true。此方法要求呼叫者持有權限Manifest.permission.SET_WALLPAPER。需要Manifest.permission.SET_WALLPAPER

擲出：IOException 如果嘗試根據提供的影像資料設定桌布時發生錯誤。

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

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

適用於

SetStream(Stream, Rect, Boolean)

將目前系統的桌布改成特定的位元組串流，並指定要顯示完整影像哪個子矩形的提示。

[Android.Runtime.Register("setStream", "(Ljava/io/InputStream;Landroid/graphics/Rect;Z)I", "GetSetStream_Ljava_io_InputStream_Landroid_graphics_Rect_ZHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual int SetStream(System.IO.Stream? bitmapData, Android.Graphics.Rect? visibleCropHint, bool allowBackup);

[<Android.Runtime.Register("setStream", "(Ljava/io/InputStream;Landroid/graphics/Rect;Z)I", "GetSetStream_Ljava_io_InputStream_Landroid_graphics_Rect_ZHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetStream : System.IO.Stream * Android.Graphics.Rect * bool -> int
override this.SetStream : System.IO.Stream * Android.Graphics.Rect * bool -> int

參數

bitmapData: Stream

InputStream：包含原始資料，需安裝為桌布的串流。這些資料可以是 BitmapRegionDecoder 處理的任何格式。

visibleCropHint: Rect

Rect：串流影像中應作為桌布顯示的矩形子區域。針對此參數傳送空值，表示根據影像與裝置的長寬比等條件，應盡可能顯示完整影像。

allowBackup: Boolean

布林值：如果作業系統允許備份此桌布映像以還原到未來裝置，則為真;否則就是錯誤的。

傳回

Int32

一個分配給新啟用桌布的整數 ID;或者失敗的機率為零。

屬性: RegisterAttribute RequiresPermissionAttribute

備註

將目前系統的桌布改成特定的位元組串流，並指定要顯示完整影像哪個子矩形的提示。作業系統會嘗試將完整影像中指定部分呈現為靜態系統桌布影像。來自給定 InputStream 的資料會被複製到持久儲存，然後用作系統桌布。目前資料必須是 JPEG 或 PNG 圖片。成功後，意圖Intent.ACTION_WALLPAPER_CHANGED會被廣播。此方法要求呼叫者持有權限Manifest.permission.SET_WALLPAPER。需要Manifest.permission.SET_WALLPAPER

另請參閱：

擲出：IOException 如果嘗試根據提供的影像資料設定桌布時發生錯誤。

拋出：IllegalArgumentException 如果可見的 CropHint 矩形為空或無效。

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

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

適用於

SetStream(Stream, Rect, Boolean, WallpaperManagerFlags)

setStream（InputStream， Rect， boolean）的版本，允許呼叫者指定要設定哪些支援的壁紙類別。

[Android.Runtime.Register("setStream", "(Ljava/io/InputStream;Landroid/graphics/Rect;ZI)I", "GetSetStream_Ljava_io_InputStream_Landroid_graphics_Rect_ZIHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")]
public virtual int SetStream(System.IO.Stream? bitmapData, Android.Graphics.Rect? visibleCropHint, bool allowBackup, Android.App.WallpaperManagerFlags which);

[<Android.Runtime.Register("setStream", "(Ljava/io/InputStream;Landroid/graphics/Rect;ZI)I", "GetSetStream_Ljava_io_InputStream_Landroid_graphics_Rect_ZIHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.SET_WALLPAPER")>]
abstract member SetStream : System.IO.Stream * Android.Graphics.Rect * bool * Android.App.WallpaperManagerFlags -> int
override this.SetStream : System.IO.Stream * Android.Graphics.Rect * bool * Android.App.WallpaperManagerFlags -> int

參數

bitmapData: Stream

InputStream：包含原始資料，需安裝為桌布的串流。這些資料可以是 BitmapRegionDecoder 處理的任何格式。

visibleCropHint: Rect

Rect：串流影像中應作為桌布顯示的矩形子區域。針對此參數傳送空值，表示根據影像與裝置的長寬比等條件，應盡可能顯示完整影像。

allowBackup: Boolean

布林值：如果作業系統允許備份此桌布映像以還原到未來裝置，則為真;否則就是錯誤的。

which: WallpaperManagerFlags

int：標示哪些桌布要搭配新影像設定。價值為0或以下組合：FLAG_SYSTEM FLAG_LOCK

傳回

Int32

一個分配給新啟用桌布的整數 ID;或者失敗的機率為零。

屬性: RegisterAttribute RequiresPermissionAttribute

備註

setStream（InputStream， Rect， boolean）的版本，允許呼叫者指定要設定哪些支援的壁紙類別。需要Manifest.permission.SET_WALLPAPER

另請參閱：

擲出：java.io.IOException

投擲：IOException

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

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

適用於