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 英吋) 1/96 英吋。 (繼承來源 BitmapSource) |
| IsDownloading |
取得值，這個值表示目前是否正在下載 BitmapSource 內容。 (繼承來源 BitmapSource) |
| IsFrozen |
取得值，該值表示物件目前是否可修改。 (繼承來源 Freezable) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| Metadata |
取得與這個點陣圖影像相關聯的中繼資料 (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) |
