BitmapImage Класс

Определение

Пространство имен:: System.Windows.Media.Imaging

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет специализированный BitmapSource интерфейс, оптимизированный для загрузки изображений с помощью языка разметки расширяемых приложений (XAML).

public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContext

public sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContext

type BitmapImage = class
    inherit BitmapSource
    interface ISupportInitialize
    interface IUriContext

Public NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext

Наследование: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
BitmapImage

Реализации: ISupportInitialize IUriContext

Примеры

В следующих примерах кода показано, как использовать BitmapImage язык разметки расширяемых приложений (XAML) и код.

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;

' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

BitmapImage в основном существует для поддержки синтаксиса языка разметки приложений (XAML) расширяемого приложения и содержит дополнительные свойства для загрузки растровых BitmapSourceкарт, которые не определены.

BitmapImage ISupportInitialize реализует интерфейс для оптимизации инициализации для нескольких свойств. Изменения свойств могут возникать только во время инициализации объектов. Вызов сигнала BeginInit о начале инициализации и EndInit сигнал о завершении инициализации. После инициализации изменения свойств игнорируются.

BitmapImage объекты, созданные с помощью конструктора BitmapImage , автоматически инициализированы, а изменения свойств игнорируются.

Конструкторы

Имя	Описание
BitmapImage()	Инициализирует новый экземпляр класса BitmapImage.
BitmapImage(Uri, RequestCachePolicy)	Инициализирует новый экземпляр BitmapImage класса с изображением, источником которого является Uriисточник, и кэшируется в соответствии с предоставленным RequestCachePolicy.
BitmapImage(Uri)	Инициализирует новый экземпляр класса с помощью предоставленного BitmapImage Uri.

Поля

Имя	Описание
CacheOptionProperty	Определяет CacheOption свойство зависимостей.
CreateOptionsProperty	Определяет CreateOptions свойство зависимостей.
DecodePixelHeightProperty	Определяет DecodePixelHeight свойство зависимостей.
DecodePixelWidthProperty	Определяет DecodePixelWidth свойство зависимостей.
RotationProperty	Определяет Rotation свойство зависимостей.
SourceRectProperty	Определяет SourceRect свойство зависимостей.
StreamSourceProperty	Определяет StreamSource свойство зависимостей.
UriCachePolicyProperty	Определяет UriCachePolicy свойство зависимостей.
UriSourceProperty	Определяет UriSource свойство зависимостей.

Свойства

Имя	Описание
BaseUri	Возвращает или задает значение, представляющее базу Uri текущего BitmapImage контекста.
CacheOption	Возвращает или задает используемый BitmapCacheOption для этого экземпляра BitmapImage.
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
CreateOptions	Возвращает или задает BitmapCreateOptions значение для BitmapImageпараметра .
DecodePixelHeight	Возвращает или задает высоту в пикселях, в которую декодируется изображение.
DecodePixelWidth	Возвращает или задает ширину (в пикселях), в которую декодируется изображение.
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
DpiX	Получает горизонтальные точки на дюйм (dpi) изображения. (Унаследовано от BitmapSource)
DpiY	Получает вертикальные точки на дюйм (dpi) изображения. (Унаследовано от BitmapSource)
Format	Возвращает собственный PixelFormat код данных растрового изображения. (Унаследовано от BitmapSource)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
Height	Получает высоту исходного растрового изображения в устройствах независимо от устройства (1/96-й дюйм на единицу). (Унаследовано от BitmapSource)
IsDownloading	Возвращает значение, указывающее, загружается ли BitmapImage содержимое в данный момент.
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Metadata	Не поддерживается. BitmapImage не поддерживает Metadata свойство и вызовет NotSupportedExceptionисключение.
Palette	Возвращает цветовую палитру растрового изображения, если он указан. (Унаследовано от BitmapSource)
PixelHeight	Возвращает высоту растрового изображения в пикселях. (Унаследовано от BitmapSource)
PixelWidth	Возвращает ширину растрового изображения в пикселях. (Унаследовано от BitmapSource)
Rotation	Возвращает или задает угол поворота BitmapImage .
SourceRect	Возвращает или задает прямоугольник, используемый в качестве источника BitmapImage.
StreamSource	Возвращает или задает источник потока объекта BitmapImage.
UriCachePolicy	Возвращает или задает значение, представляющее политику кэширования изображений, поступающих из источника HTTP.
UriSource	Возвращает или задает Uri источник BitmapImageобъекта .
Width	Получает ширину растрового изображения в единицах, независимых от устройства (1/96-й дюйм на единицу). (Унаследовано от BitmapSource)

Методы

Имя	Описание
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginInit()	Сигнализирует о начале BitmapImage инициализации.
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
CheckIfSiteOfOrigin()	Проверяет, находится ли исходное содержимое растрового изображения из известного сайта источника. Этот метод используется для обеспечения безопасности операций копирования пикселей. (Унаследовано от BitmapSource)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон этого BitmapImageобъекта, делая глубокие копии значений этого объекта.
CloneCore(Freezable)	Делает этот экземпляр глубокой копией указанного BitmapSource. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. (Унаследовано от BitmapSource)
CloneCurrentValue()	Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого BitmapImage объекта. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения.
CloneCurrentValueCore(Freezable)	Делает этот экземпляр изменяемым глубоким копированием указанного BitmapSource с использованием текущих значений свойств. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от BitmapSource)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CopyPixels(Array, Int32, Int32)	Копирует данные пикселя растрового изображения в массив пикселей с указанным шагом, начиная с указанного смещения. (Унаследовано от BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Копирует данные пикселя растрового изображения в указанном прямоугольнике в массив пикселей с указанным шагом, начиная с указанного смещения. (Унаследовано от BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Копирует данные пикселя растрового изображения в указанном прямоугольнике. (Унаследовано от BitmapSource)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
EndInit()	Сигнализирует о завершении BitmapImage инициализации.
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает экземпляр BitmapSource или производный класс неизменяемым. (Унаследовано от BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает этот экземпляр клоном указанного BitmapSource объекта. (Унаследовано от BitmapSource)
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает этот экземпляр замороженным клоном указанного.BitmapSource Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от BitmapSource)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Создает строковое представление этого объекта на основе текущего языка и региональных параметров. (Унаследовано от ImageSource)
ToString(IFormatProvider)	Создает строковое представление этого объекта на основе переданного IFormatProvider объекта. Если поставщик имеет значение `null`, CurrentCulture используется. (Унаследовано от ImageSource)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Имя	Описание
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)
DecodeFailed	Происходит при сбое загрузки изображения из-за поврежденного заголовка образа. (Унаследовано от BitmapSource)
DownloadCompleted	Происходит, когда содержимое растрового изображения было полностью загружено. (Унаследовано от BitmapSource)
DownloadFailed	Происходит при сбое скачивания содержимого растрового изображения. (Унаследовано от BitmapSource)
DownloadProgress	Происходит при изменении хода скачивания содержимого растрового изображения. (Унаследовано от BitmapSource)

Явные реализации интерфейса

Имя	Описание
IFormattable.ToString(String, IFormatProvider)	Форматирует значение текущего экземпляра с помощью указанного формата. (Унаследовано от ImageSource)

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?