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) 建構子建立的物件會自動初始化，屬性變更則被忽略。
A ColorConvertedBitmap 從來不會被快取。
建構函式
| 名稱 | Description |
|---|---|
| ColorConvertedBitmap() |
初始化 ColorConvertedBitmap 類別的新執行個體。 |
| ColorConvertedBitmap(BitmapSource, ColorContext, ColorContext, PixelFormat) |
使用指定的值初始化該類別的新 ColorConvertedBitmap 實例。 |
欄位
| 名稱 | Description |
|---|---|
| DestinationColorContextProperty |
識別 DestinationColorContext 依賴性質。 |
| DestinationFormatProperty |
識別 DestinationFormat 依賴性質。 |
| SourceColorContextProperty |
識別 SourceColorContext 依賴性質。 |
| SourceProperty |
識別 Source 依賴性質。 |
屬性
| 名稱 | Description |
|---|---|
| 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) |
方法
事件
| 名稱 | Description |
|---|---|
| Changed |
當 Freezable 它所包含的物件被修改時，會發生這種情況。 (繼承來源 Freezable) |
| DecodeFailed |
當影像檔因檔案標頭損毀而無法載入時，會發生這種情況。 (繼承來源 BitmapSource) |
| DownloadCompleted |
當點陣圖內容已經完全下載完畢時，會發生這種情況。 (繼承來源 BitmapSource) |
| DownloadFailed |
當點陣圖內容下載失敗時會發生。 (繼承來源 BitmapSource) |
| DownloadProgress |
當點陣圖內容的下載進度改變時，會發生這種情況。 (繼承來源 BitmapSource) |
明確介面實作
| 名稱 | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
使用指定的格式，格式化目前實例的值。 (繼承來源 ImageSource) |
