WmpBitmapDecoder 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 WmpBitmapDecoder 的新執行個體。
多載
WmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption) |
使用指定的 |
WmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption) |
使用指定的 |
WmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)
使用指定的 createOptions
和 cacheOption
,從指定的檔案資料流初始化 WmpBitmapDecoder 的新執行個體。
public:
WmpBitmapDecoder(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
[System.Security.SecurityCritical]
public WmpBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
public WmpBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.WmpBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.WmpBitmapDecoder
new System.Windows.Media.Imaging.WmpBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.WmpBitmapDecoder
Public Sub New (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)
參數
- bitmapStream
- Stream
要解碼的點陣圖資料流。
- createOptions
- BitmapCreateOptions
點陣圖影像的初始化選項。
- cacheOption
- BitmapCacheOption
點陣圖影像的快取方法。
- 屬性
例外狀況
bitmapStream
值為 null
。
bitmapStream
不是媒體相片編碼影像Windows。
範例
下列程式碼範例示範如何從檔案資料流程建立 和使用 WmpBitmapDecoder 的實例。 解碼的 Image 影像會當做控制項的來源使用。
// Open a Stream and decode a WDP image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.wdp", FileMode::Open, FileAccess::Read, FileShare::Read);
WmpBitmapDecoder^ decoder = gcnew WmpBitmapDecoder(imageStreamSource, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource = decoder->Frames[0];
// Draw the Image
Image^ myImage = gcnew Image();
myImage->Source = bitmapSource;
myImage->Stretch = Stretch::None;
myImage->Margin = System::Windows::Thickness(20);
// Open a Stream and decode a WDP image
Stream imageStreamSource = new FileStream("tulipfarm.wdp", FileMode.Open, FileAccess.Read, FileShare.Read);
WmpBitmapDecoder decoder = new WmpBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];
// Draw the Image
Image myImage = new Image();
myImage.Source = bitmapSource;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(20);
' Open a Stream and decode a WDP image
Dim imageStreamSource As New FileStream("tulipfarm.wdp", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New WmpBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)
' Draw the Image
Dim myImage As New Image()
myImage.Source = bitmapSource
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(20)
備註
如果您想要在解碼器建立之後關閉 bitmapStream
,請使用快 OnLoad 取選項。 預設快 OnDemand 取選項會保留資料流程的存取權,直到需要點陣圖,並由垃圾收集行程處理清除為止。
適用於
WmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)
使用指定的 createOptions
和 cacheOption
,從指定的 WmpBitmapDecoder 初始化 Uri 的新執行個體。
public:
WmpBitmapDecoder(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
[System.Security.SecurityCritical]
public WmpBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
public WmpBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.WmpBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.WmpBitmapDecoder
new System.Windows.Media.Imaging.WmpBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.WmpBitmapDecoder
Public Sub New (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)
參數
- createOptions
- BitmapCreateOptions
點陣圖影像的初始化選項。
- cacheOption
- BitmapCacheOption
點陣圖影像的快取方法。
- 屬性
例外狀況
bitmapUri
值為 null
。
bitmapUri
不是媒體相片編碼影像Windows。
範例
下列程式碼範例示範如何建立 的實例,以及從 Uri 使用 WmpBitmapDecoder 。 解碼的 Image 影像會當做控制項的來源使用。
// Open a Uri and decode a WDP image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.wdp", UriKind::RelativeOrAbsolute);
WmpBitmapDecoder^ decoder3 = gcnew WmpBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource3 = decoder3->Frames[0];
// Draw the Image
Image^ myImage2 = gcnew Image();
myImage2->Source = bitmapSource3;
myImage2->Stretch = Stretch::None;
myImage2->Margin = System::Windows::Thickness(20);
// Open a Uri and decode a WDP image
Uri myUri = new Uri("tulipfarm.wdp", UriKind.RelativeOrAbsolute);
WmpBitmapDecoder decoder3 = new WmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource3 = decoder3.Frames[0];
// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource3;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);
' Open a Uri and decode a WDP image
Dim myUri As New Uri("tulipfarm.wdp", UriKind.RelativeOrAbsolute)
Dim decoder3 As New WmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource3 As BitmapSource = decoder3.Frames(0)
' Draw the Image
Dim myImage2 As New Image()
myImage2.Source = bitmapSource3
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)