BmpBitmapDecoder Construtores

Definição

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Inicializa uma nova instância de BmpBitmapDecoder.

Sobrecargas

BmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	Inicializa uma nova instância de BmpBitmapDecoder do fluxo de arquivos especificado, com o createOptions e cacheOption especificados.
BmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	Inicializa uma nova instância de BmpBitmapDecoder do Uri especificado com os createOptions e cacheOption especificados.

BmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

Inicializa uma nova instância de BmpBitmapDecoder do fluxo de arquivos especificado, com o createOptions e cacheOption especificados.

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

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

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

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

Parâmetros

bitmapStream

Stream

O fluxo de bitmap a ser decodificado.

createOptions

BitmapCreateOptions

Opções de inicialização para a imagem bitmap.

cacheOption

BitmapCacheOption

O método de cache a ser usado para a imagem de bitmap.

Exceções

ArgumentNullException

O valor bitmapStream é null.

FileFormatException

O bitmapStream não é uma imagem codificada em BMP (bitmap).

Exemplos

O exemplo de código a seguir demonstra como criar uma instância de e usar um BmpBitmapDecoder de um fluxo de arquivos. A imagem decodificada é usada como a origem de um Image controle.

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

Comentários

Use a opção OnLoad de cache se desejar fechar o bitmapStream após a criação do decodificador. A opção de cache padrão OnDemand mantém o acesso ao fluxo até que o bitmap seja necessário e a limpeza seja tratada pelo coletor de lixo.

BmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

Inicializa uma nova instância de BmpBitmapDecoder do Uri especificado com os createOptions e cacheOption especificados.

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

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

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

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

Parâmetros

bitmapUri

Uri

O Uri que identifica o bitmap a ser decodificado.

createOptions

BitmapCreateOptions

Opções de inicialização para a imagem bitmap.

cacheOption

BitmapCacheOption

O método de cache a ser usado para a imagem de bitmap.

Exceções

ArgumentNullException

O valor bitmapUri é null.

FileFormatException

O bitmapUri não é uma imagem codificada em BMP (bitmap).

Exemplos

O exemplo de código a seguir demonstra como criar uma instância de e usar uma BmpBitmapDecoder de um Uri. A imagem decodificada é usada como a origem de um Image controle.

// Open a Uri and decode a BMP image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.bmp", UriKind::RelativeOrAbsolute);
BmpBitmapDecoder^ decoder2 = gcnew BmpBitmapDecoder(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 BMP image
Uri myUri = new Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute);
BmpBitmapDecoder decoder2 = new BmpBitmapDecoder(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 BMP image
Dim myUri As New Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute)
Dim decoder2 As New BmpBitmapDecoder(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)