WallpaperManager.SetBitmap Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
SetBitmap(Bitmap, Rect, Boolean, WallpaperManagerFlags) |
|
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
Прямоугольный прямоугольник fullImage
, который должен отображаться в виде обоев. Передача null
этого параметра означает, что полное изображение должно отображаться, если это возможно, учитывая пропорции изображения и устройства и т. д.
- allowBackup
- Boolean
true
Значение , если ОС разрешено создать резервную копию этого изображения для восстановления на будущем устройстве; false
иначе.
- which
- WallpaperManagerFlags
Флаги, указывающие, какие обои следует настроить с помощью нового образа.
Возвращаемое значение
Целочисленный идентификатор, назначенный только что активному обою; или ноль при сбое.
- Атрибуты
Комментарии
#setBitmap(Bitmap, Rect, boolean)
Версия этого позволяет вызывающему объекту указать, какие из поддерживаемых категорий обоев следует задать.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
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
Прямоугольный прямоугольник fullImage
, который должен отображаться в виде обоев. Передача null
этого параметра означает, что полное изображение должно отображаться, если это возможно, учитывая пропорции изображения и устройства и т. д.
- allowBackup
- Boolean
true
Значение , если ОС разрешено создать резервную копию этого изображения для восстановления на будущем устройстве; false
иначе.
Возвращаемое значение
Целочисленный идентификатор, назначенный только что активному обою; или ноль при сбое.
- Атрибуты
Комментарии
Измените текущий фон системы на растровое изображение, указав указание о том, какой подрезок полного изображения должен быть видимым. Затем ОС попытается лучше представить данную часть полного изображения в качестве статического образа системы. При успешном выполнении намерение Intent#ACTION_WALLPAPER_CHANGED
передается.
Передача null
в качестве visibleHint
параметра эквивалентна передаче (0, 0, fullImage.getWidth()
, , ). fullImage.getHeight()
Для этого метода требуется, чтобы вызывающий объект держал разрешение android.Manifest.permission#SET_WALLPAPER
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
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, boolean)
и передаче null
прямоугольника visibleCrop
и true
параметру allowBackup
.
Для этого метода требуется, чтобы вызывающий объект держал разрешение android.Manifest.permission#SET_WALLPAPER
.
Документация по Java для android.app.WallpaperManager.setBitmap(android.graphics.Bitmap)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.