CachedBitmap 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供 BitmapSource.
public ref class CachedBitmap sealed : System::Windows::Media::Imaging::BitmapSourcepublic sealed class CachedBitmap : System.Windows.Media.Imaging.BitmapSourcetype CachedBitmap = class
inherit BitmapSourcePublic NotInheritable Class CachedBitmap
Inherits BitmapSource- 繼承
範例
以下程式碼範例說明如何建立並使用 in CachedBitmap code。
CachedBitmap cachedSource = new CachedBitmap(
scaledSource,
BitmapCreateOptions.None,
BitmapCacheOption.OnLoad);
// Create a new BitmapSource using a different format than the original one.
FormatConvertedBitmap newFormatSource = new FormatConvertedBitmap();
newFormatSource.BeginInit();
newFormatSource.Source = cachedSource;
newFormatSource.DestinationFormat = PixelFormats.Gray32Float;
newFormatSource.EndInit();
Dim cachedSource As New CachedBitmap(scaledSource, BitmapCreateOptions.None, BitmapCacheOption.OnLoad)
' Create a new BitmapSource using a different format than the original one.
Dim newFormatSource As New FormatConvertedBitmap()
newFormatSource.BeginInit()
newFormatSource.Source = cachedSource
newFormatSource.DestinationFormat = PixelFormats.Gray32Float
newFormatSource.EndInit()
備註
A BitmapSource 不會自動快取位圖資料。 在需要在同一位圖上執行多項操作（如裁切影像或縮放）的情況下，使用 a CachedBitmap 可以提升效能。
建構函式
| 名稱 | Description |
|---|---|
| CachedBitmap(BitmapSource, BitmapCreateOptions, BitmapCacheOption) |
初始化一個新的實例，該實例 CachedBitmap 包含指定的來源、位圖建立選項及位圖快取選項。 |
屬性
| 名稱 | Description |
|---|---|
| CanFreeze |
會得到一個值，表示該物件是否能被設定為不可修改。 (繼承來源 Freezable) |
| 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 |
會得到一個值，表示內容是否 BitmapSource 正在下載中。 (繼承來源 BitmapSource) |
| IsFrozen |
會得到一個值，表示該物件目前是否可修改。 (繼承來源 Freezable) |
| IsSealed |
會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject) |
| Metadata |
取得與此點陣圖影像相關的元資料。 (繼承來源 BitmapSource) |
| Palette |
如果有指定，會取得點陣圖的色彩調色盤。 (繼承來源 BitmapSource) |
| PixelHeight |
它會取得點陣圖的高度（像素單位）。 (繼承來源 BitmapSource) |
| PixelWidth |
會得到點陣圖的寬度（像素數）。 (繼承來源 BitmapSource) |
| Width |
以裝置獨立單位取得位圖寬度（每單位 1/96 英吋）。 (繼承來源 BitmapSource) |
方法
事件
| 名稱 | Description |
|---|---|
| Changed |
當 Freezable 它所包含的物件被修改時，會發生這種情況。 (繼承來源 Freezable) |
| DecodeFailed |
當影像檔因檔案標頭損毀而無法載入時，會發生這種情況。 (繼承來源 BitmapSource) |
| DownloadCompleted |
當點陣圖內容已經完全下載完畢時，會發生這種情況。 (繼承來源 BitmapSource) |
| DownloadFailed |
當點陣圖內容下載失敗時會發生。 (繼承來源 BitmapSource) |
| DownloadProgress |
當點陣圖內容的下載進度改變時，會發生這種情況。 (繼承來源 BitmapSource) |
明確介面實作
| 名稱 | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
使用指定的格式，格式化目前實例的值。 (繼承來源 ImageSource) |
