BitmapFrame.Create Método

Referência

Definição

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um novo BitmapFrame com base nos argumentos fornecidos.

Sobrecargas

Create(Stream)	Cria um novo BitmapFrame de um determinado Stream.
Create(Uri)	Cria um novo BitmapFrame de um determinado Uri.
Create(BitmapSource)	Cria um novo BitmapFrame de um determinado BitmapSource.
Create(Uri, RequestCachePolicy)	Cria um BitmapFrame de um determinado Uri com RequestCachePolicy especificado.
Create(BitmapSource, BitmapSource)	Cria um novo BitmapFrame de um determinado BitmapSource com a miniatura especificada.
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Cria um novo BitmapFrame de um determinado Stream com o BitmapCreateOptions e BitmapCacheOption especificados.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Cria um BitmapFrame de um determinado Uri com os BitmapCreateOptions e BitmapCacheOption especificados.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Cria um BitmapFrame de um determinado Uri com os BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	Cria um novo BitmapFrame de um determinado BitmapSource com a miniatura especificada, BitmapMetadata e ColorContext.

Create(Stream)

Cria um novo BitmapFrame de um determinado Stream.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::IO::Stream ^ bitmapStream);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.IO.Stream bitmapStream);

static member Create : System.IO.Stream -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream) As BitmapFrame

Parâmetros

bitmapStream: Stream

O Stream usado para construir o BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Stream.

Comentários

O bitmapStream pode ser fechado depois que o quadro é criado somente quando a opção OnLoad de cache é usada. A opção de cache padrão OnDemand mantém o fluxo até que o quadro seja necessário. Use o Create(Stream, BitmapCreateOptions, BitmapCacheOption) método para especificar opções de criação e cache.

Aplica-se a

Create(Uri)

Cria um novo BitmapFrame de um determinado Uri.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri);

static member Create : Uri -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri) As BitmapFrame

Parâmetros

bitmapUri: Uri

O Uri que identifica a origem do BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Uri.

Exemplos

O exemplo de código a seguir demonstra como construir um BitmapFrame a partir de um determinado Uri.

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

Aplica-se a

Create(BitmapSource)

Cria um novo BitmapFrame de um determinado BitmapSource.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source);

static member Create : System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource) As BitmapFrame

Parâmetros

source: BitmapSource

O BitmapSource usado para construir este BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado BitmapSource.

Aplica-se a

Create(Uri, RequestCachePolicy)

Cria um BitmapFrame de um determinado Uri com RequestCachePolicy especificado.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, uriCachePolicy As RequestCachePolicy) As BitmapFrame

Parâmetros

bitmapUri: Uri

O local do bitmap do qual o BitmapFrame é criado.

uriCachePolicy: RequestCachePolicy

Os requisitos de cache para este BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Uri com o RequestCachePolicy especificado.

Comentários

Create(Uri, RequestCachePolicy)é introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.

Aplica-se a

Create(BitmapSource, BitmapSource)

Cria um novo BitmapFrame de um determinado BitmapSource com a miniatura especificada.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource) As BitmapFrame

Parâmetros

source: BitmapSource

A origem da qual o BitmapFrame é construído.

thumbnail: BitmapSource

Uma imagem em miniatura do BitmapFrame resultante.

Retornos

BitmapFrame

Um BitmapFrame de um determinado BitmapSource com a miniatura especificada.

Aplica-se a

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um novo BitmapFrame de um determinado Stream com o BitmapCreateOptions e BitmapCacheOption especificados.

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

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

static member Create : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

Parâmetros

bitmapStream: Stream

O fluxo do qual este BitmapFrame é construído.

createOptions: BitmapCreateOptions

As opções usadas para criar este BitmapFrame.

cacheOption: BitmapCacheOption

As opção de cache usada para criar este BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Stream com o BitmapCreateOptions e BitmapCacheOption especificados.

Comentários

Use a opção OnLoad de cache se desejar fechar o bitmapStream após a criação do bitmap. 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.

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapFrame de um determinado Uri com os BitmapCreateOptions e BitmapCacheOption especificados.

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

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

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

Parâmetros

bitmapUri: Uri

O local do bitmap do qual o BitmapFrame é criado.

createOptions: BitmapCreateOptions

As opções usadas para criar este BitmapFrame.

cacheOption: BitmapCacheOption

As opção de cache usada para criar este BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Uri com o BitmapCreateOptions especificado e BitmapCacheOption.

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Cria um BitmapFrame de um determinado Uri com os BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption, uriCachePolicy As RequestCachePolicy) As BitmapFrame

Parâmetros

bitmapUri: Uri

O local do bitmap do qual o BitmapFrame é criado.

createOptions: BitmapCreateOptions

As opções usadas para criar este BitmapFrame.

cacheOption: BitmapCacheOption

As opção de cache usada para criar este BitmapFrame.

uriCachePolicy: RequestCachePolicy

Os requisitos de cache para este BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado Uri com os BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.

Comentários

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)é introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.

Aplica-se a

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Cria um novo BitmapFrame de um determinado BitmapSource com a miniatura especificada, BitmapMetadata e ColorContext.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail, System::Windows::Media::Imaging::BitmapMetadata ^ metadata, System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::ColorContext ^> ^ colorContexts);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail, System.Windows.Media.Imaging.BitmapMetadata metadata, System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> colorContexts);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapMetadata * System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource, metadata As BitmapMetadata, colorContexts As ReadOnlyCollection(Of ColorContext)) As BitmapFrame

Parâmetros

source: BitmapSource

O BitmapSource usado para construir este BitmapFrame.

thumbnail: BitmapSource

Uma imagem em miniatura do BitmapFrame resultante.

metadata: BitmapMetadata

Os metadados a serem associados a esse BitmapFrame.

colorContexts: ReadOnlyCollection<ColorContext>

Os objetos de ColorContext que estão associados a esse BitmapFrame.

Retornos

BitmapFrame

Um BitmapFrame de um determinado BitmapSource com a miniatura especificada, BitmapMetadata e ColorContext.

Aplica-se a

Partilhar via

BitmapFrame.Create Método

Definição

Sobrecargas

Create(Stream)

Parâmetros

Retornos

Comentários

Aplica-se a

Create(Uri)

Parâmetros

Retornos

Exemplos

Aplica-se a

Create(BitmapSource)

Parâmetros

Retornos

Aplica-se a

Create(Uri, RequestCachePolicy)

Parâmetros

Retornos

Comentários

Aplica-se a

Create(BitmapSource, BitmapSource)

Parâmetros

Retornos

Aplica-se a

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Parâmetros

Retornos

Comentários

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Parâmetros

Retornos

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Parâmetros

Retornos

Comentários

Aplica-se a

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Parâmetros

Retornos

Aplica-se a

Recursos adicionais