BitmapImage 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供一个专用的 BitmapSource，已使用 Extensible Application Markup Language (XAML) 针对加载图像进行了优化。
public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContextpublic sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContexttype BitmapImage = class
inherit BitmapSource
interface ISupportInitialize
interface IUriContextPublic NotInheritable Class BitmapImage
Inherits BitmapSource
Implements 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) |
使用提供的 BitmapImage 初始化 Uri 类的新实例。 |
| BitmapImage(Uri, RequestCachePolicy) |
使用源为 BitmapImage 并且根据所提供的 Uri 进行缓存的图像初始化 RequestCachePolicy 类的新实例。 |
字段
| CacheOptionProperty |
标识 CacheOption 依赖项属性。 |
| CreateOptionsProperty |
标识 CreateOptions 依赖项属性。 |
| DecodePixelHeightProperty |
标识 DecodePixelHeight 依赖项属性。 |
| DecodePixelWidthProperty |
标识 DecodePixelWidth 依赖项属性。 |
| RotationProperty |
标识 Rotation 依赖项属性。 |
| SourceRectProperty |
标识 SourceRect 依赖项属性。 |
| StreamSourceProperty |
标识 StreamSource 依赖项属性。 |
| UriCachePolicyProperty |
标识 UriCachePolicy 依赖项属性。 |
| UriSourceProperty |
标识 UriSource 依赖项属性。 |
属性
方法
事件
| Changed |
在修改 Freezable 或其包含的对象时发生。 (继承自 Freezable) |
| DecodeFailed |
在由于图像标题损坏而无法下载图像时发生。 (继承自 BitmapSource) |
| DownloadCompleted |
在下载完位图内容时发生。 (继承自 BitmapSource) |
| DownloadFailed |
在无法下载位图内容时发生。 (继承自 BitmapSource) |
| DownloadProgress |
在下载位图内容的进度有变化时发生。 (继承自 BitmapSource) |
显式接口实现
| IFormattable.ToString(String, IFormatProvider) |
使用指定格式对当前实例的值设置格式。 (继承自 ImageSource) |
