IconBitmapDecoder Konstruktoren

Definition

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Initialisiert eine neue Instanz der IconBitmapDecoder-Klasse.

Überlädt

IconBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	Initialisiert eine neue Instanz der IconBitmapDecoder-Klasse aus dem angegebenen Dateistream mit den angegebenen createOptions und der angegebenen cacheOption.
IconBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	Initialisiert eine neue Instanz der IconBitmapDecoder-Klasse aus dem angegebenen Uri mit den angegebenen createOptions und der angegebenen cacheOption.

IconBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

Initialisiert eine neue Instanz der IconBitmapDecoder-Klasse aus dem angegebenen Dateistream mit den angegebenen createOptions und der angegebenen cacheOption.

public:
 IconBitmapDecoder(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public IconBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

new System.Windows.Media.Imaging.IconBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.IconBitmapDecoder

Public Sub New (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Parameter

bitmapStream

Stream

Der zu decodierende Bitmapstream.

createOptions

BitmapCreateOptions

Initialisierungsoptionen für das Bitmap-Bild.

cacheOption

BitmapCacheOption

Die Zwischenspeicherungsmethode, die für das Bitmap-Bild verwendet werden soll.

Ausnahmen

ArgumentNullException

Der bitmapStream-Wert ist null.

FileFormatException

Der bitmapStream ist kein ICO-codiertes Bild.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz von erstellt und aus einem Dateistream verwendet wird GifBitmapDecoder .

// Open a Stream and decode a GIF image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.gif", FileMode::Open, FileAccess::Read, FileShare::Read);
GifBitmapDecoder^ decoder = gcnew GifBitmapDecoder(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 GIF image
Stream imageStreamSource = new FileStream("tulipfarm.gif", FileMode.Open, FileAccess.Read, FileShare.Read);
GifBitmapDecoder decoder = new GifBitmapDecoder(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 GIF image
Dim imageStreamSource As New FileStream("tulipfarm.gif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New GifBitmapDecoder(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)

Hinweise

Verwenden Sie die OnLoad Cacheoption, wenn Sie die bitmapStream schließen möchten, nachdem die Bitmap erstellt wurde. Die Standardcacheoption OnDemand behält den Zugriff auf den Stream bei, bis die Bitmap benötigt wird und die Bereinigung vom Garbage Collector verarbeitet wird.

IconBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

Initialisiert eine neue Instanz der IconBitmapDecoder-Klasse aus dem angegebenen Uri mit den angegebenen createOptions und der angegebenen cacheOption.

public:
 IconBitmapDecoder(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public IconBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

new System.Windows.Media.Imaging.IconBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.IconBitmapDecoder

Public Sub New (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Parameter

bitmapUri

Uri

Der Uri, der die zu decodierende Bitmap bezeichnet.

createOptions

BitmapCreateOptions

Initialisierungsoptionen für das Bitmap-Bild.

cacheOption

BitmapCacheOption

Die Zwischenspeicherungsmethode, die für das Bitmap-Bild verwendet werden soll.

Ausnahmen

ArgumentNullException

Der bitmapUri-Wert ist null.

FileFormatException

Der bitmapUri ist kein ICO-codiertes Bild.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz von erstellt und aus GifBitmapDecoder verwendet Uriwird.

// Open a Uri and decode a GIF image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.gif", UriKind::RelativeOrAbsolute);
GifBitmapDecoder^ decoder2 = gcnew GifBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource2 = decoder2->Frames[0];

// Draw the Image
Image^ myImage2 = gcnew Image();
myImage2->Source = bitmapSource2;
myImage2->Stretch = Stretch::None;
myImage2->Margin = System::Windows::Thickness(20);

// Open a Uri and decode a GIF image
Uri myUri = new Uri("tulipfarm.gif", UriKind.RelativeOrAbsolute);
GifBitmapDecoder decoder2 = new GifBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];

// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

' Open a Uri and decode a GIF image
Dim myUri As New Uri("tulipfarm.gif", UriKind.RelativeOrAbsolute)
Dim decoder2 As New GifBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource2 As BitmapSource = decoder2.Frames(0)

' Draw the Image
Dim myImage2 As New Image()
myImage2.Source = bitmapSource2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)