ColorConvertedBitmap 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
更改 BitmapSource 的颜色空间。
public ref class ColorConvertedBitmap sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitializepublic sealed class ColorConvertedBitmap : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitializetype ColorConvertedBitmap = class
inherit BitmapSource
interface ISupportInitializePublic NotInheritable Class ColorConvertedBitmap
Inherits BitmapSource
Implements ISupportInitialize- 继承
-
ColorConvertedBitmap
- 实现
示例
以下示例演示如何创建 实例 ColorConvertedBitmap 并使用它来转换颜色。
Stream imageStream = new FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read);
BitmapSource myBitmapSource = BitmapFrame.Create(imageStream);
BitmapFrame myBitmapSourceFrame = (BitmapFrame)myBitmapSource;
ColorContext sourceColorContext = myBitmapSourceFrame.ColorContexts[0];
ColorContext destColorContext = new ColorContext(PixelFormats.Bgra32);
ColorConvertedBitmap ccb = new ColorConvertedBitmap(myBitmapSource, sourceColorContext, destColorContext, PixelFormats.Pbgra32);
Image myImage3 = new Image();
myImage3.Source = ccb;
myImage3.Stretch = Stretch.None;
imageStream.Close();
Dim imageStream As New FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim myBitmapSource As BitmapSource = BitmapFrame.Create(imageStream)
Dim myBitmapSourceFrame As BitmapFrame = CType(myBitmapSource, BitmapFrame)
Dim sourceColorContext As ColorContext = myBitmapSourceFrame.ColorContexts(0)
Dim destColorContext As New ColorContext(PixelFormats.Bgra32)
Dim ccb As New ColorConvertedBitmap(myBitmapSource, sourceColorContext, destColorContext, PixelFormats.Pbgra32)
Dim myImage3 As New Image()
myImage3.Source = ccb
myImage3.Stretch = Stretch.None
imageStream.Close()
注解
有关 XAML 用法信息，请参阅 ColorConvertedBitmap 标记扩展。
ColorConvertedBitmap 实现 ISupportInitialize 接口，以对多个属性的初始化进行优化。 只能在对象初始化过程中进行属性更改。 调用 BeginInit 以指示初始化已开始，调用 EndInit 以指示初始化已结束。 初始化后，将忽略属性更改。
ColorConvertedBitmap 使用 ColorConvertedBitmap(BitmapSource, ColorContext, ColorContext, PixelFormat) 构造函数创建的对象将自动初始化，并忽略属性更改。
ColorConvertedBitmap永远不会缓存 。
构造函数
| ColorConvertedBitmap() |
初始化 ColorConvertedBitmap 类的新实例。 |
| ColorConvertedBitmap(BitmapSource, ColorContext, ColorContext, PixelFormat) |
通过使用指定的值初始化 ColorConvertedBitmap 类的新实例。 |
字段
| DestinationColorContextProperty |
标识 DestinationColorContext 依赖项属性。 |
| DestinationFormatProperty |
标识 DestinationFormat 依赖项属性。 |
| SourceColorContextProperty |
标识 SourceColorContext 依赖项属性。 |
| SourceProperty |
标识 Source 依赖项属性。 |
属性
| CanFreeze |
获取一个值，该值指示是否可将对象变为不可修改。 (继承自 Freezable) |
| DependencyObjectType |
DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| DestinationColorContext |
获取或设置标识已转换位图的颜色配置文件（由 ColorContext 类定义）的值。 |
| DestinationFormat |
获取或设置一个值，该值表示已转换位图的 PixelFormat。 |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| DpiX |
获取图像) dpi (英寸的水平点数。 (继承自 BitmapSource) |
| DpiY |
获取图像的每英寸垂直点数 (dpi) 。 (继承自 BitmapSource) |
| Format |
获取位图数据的本机 PixelFormat。 (继承自 BitmapSource) |
| HasAnimatedProperties |
获取一个值，该值指示一个或多个 AnimationClock 对象是否与此对象的任何依赖项属性相关联。 (继承自 Animatable) |
| Height |
获取源位图的高度（以与设备无关的单位 (每单位) 1/96 英寸）。 (继承自 BitmapSource) |
| IsDownloading |
获取一个值，该值指示 BitmapSource 内容当前是否正在下载。 (继承自 BitmapSource) |
| IsFrozen |
获取一个值，该值指示对象当前是否可修改。 (继承自 Freezable) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| Metadata |
获取与此位图图像关联的元数据。 (继承自 BitmapSource) |
| Palette |
获取位图的调色板（如果指定了调色板）。 (继承自 BitmapSource) |
| PixelHeight |
获取位图的高度（以像素为单位）。 (继承自 BitmapSource) |
| PixelWidth |
获取位图的宽度（以像素为单位）。 (继承自 BitmapSource) |
| Source |
获取或设置标识已转换的源位图的值。 |
| SourceColorContext |
获取或设置标识源位图的颜色配置文件的值。 |
| Width |
获取位图的宽度（以与设备无关的单位 (每单位) 1/96 英寸）。 (继承自 BitmapSource) |
方法
事件
| Changed |
在修改 Freezable 或其包含的对象时发生。 (继承自 Freezable) |
| DecodeFailed |
在由于图像标题损坏而无法下载图像时发生。 (继承自 BitmapSource) |
| DownloadCompleted |
在下载完位图内容时发生。 (继承自 BitmapSource) |
| DownloadFailed |
在无法下载位图内容时发生。 (继承自 BitmapSource) |
| DownloadProgress |
在下载位图内容的进度有变化时发生。 (继承自 BitmapSource) |
显式接口实现
| IFormattable.ToString(String, IFormatProvider) |
使用指定格式对当前实例的值设置格式。 (继承自 ImageSource) |
