BitmapFrame.Create Método

Definição

Espaço de Nomes:: System.Windows.Media.Imaging

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um novo BitmapFrame com base nos argumentos fornecidos.

Sobrecargas

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

Create(Stream)

Cria um novo BitmapFrame a partir de um dado 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 que é usado para construir o BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado Stream.

Observações

Só bitmapStream podem ser fechados após a criação do frame quando a OnLoad opção de cache é utilizada. A opção de cache por defeito OnDemand mantém o fluxo até que o frame 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 a partir de um dado 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.

Devoluções

BitmapFrame

A BitmapFrame de um dado Uri.

Exemplos

O seguinte exemplo de código demonstra como construir um BitmapFrame a partir de um dado 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 a partir de um dado 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 que é usado para construir este BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado BitmapSource.

Aplica-se a

Create(Uri, RequestCachePolicy)

Cria um BitmapFrame a partir de um dado Uri com o especificado RequestCachePolicy.

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

A localização do bitmap a partir do qual o BitmapFrame é criado.

uriCachePolicy: RequestCachePolicy

Os requisitos de cache para este BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado Uri com o especificado RequestCachePolicy.

Observações

Create(Uri, RequestCachePolicy) é introduzido na versão 3.5 do .NET Framework. Para mais informações, consulte Versões e Dependências.

Aplica-se a

Create(BitmapSource, BitmapSource)

Cria um novo BitmapFrame a partir de um dado 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 fonte a partir da qual o BitmapFrame é construído.

thumbnail: BitmapSource

Uma imagem em miniatura do resultado BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado BitmapSource com a miniatura especificada.

Aplica-se a

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um novo BitmapFrame a partir de um dado Stream com o especificado BitmapCreateOptions e BitmapCacheOption.

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 de água a partir do qual isto BitmapFrame é construído.

createOptions: BitmapCreateOptions

As opções que são usadas para criar isto BitmapFrame.

cacheOption: BitmapCacheOption

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

Devoluções

BitmapFrame

A BitmapFrame de um dado Stream com o especificado BitmapCreateOptions e BitmapCacheOption.

Observações

Use a OnLoad opção de cache se quiser fechar depois bitmapStream de criar o bitmap. A opção de cache por defeito 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 a partir de um dado Uri com o especificado BitmapCreateOptions e BitmapCacheOption.

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

A localização do bitmap a partir do qual o BitmapFrame é criado.

createOptions: BitmapCreateOptions

As opções que são usadas para criar isto BitmapFrame.

cacheOption: BitmapCacheOption

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

Devoluções

BitmapFrame

A BitmapFrame de um dado Uri com o especificado BitmapCreateOptions, e BitmapCacheOption.

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Cria a BitmapFrame partir de um dado Uri com os especificados BitmapCreateOptions, BitmapCacheOption, e RequestCachePolicy.

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

A localização do bitmap a partir do qual o BitmapFrame é criado.

createOptions: BitmapCreateOptions

As opções que são usadas para criar isto BitmapFrame.

cacheOption: BitmapCacheOption

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

uriCachePolicy: RequestCachePolicy

Os requisitos de cache para este BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado Uri com o especificado BitmapCreateOptions, BitmapCacheOption, e RequestCachePolicy.

Observações

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) é introduzido na versão 3.5 do .NET Framework. Para mais informações, consulte Versões e Dependências.

Aplica-se a

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

Cria um novo BitmapFrame a partir de um dado 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 que é usado para construir este BitmapFrame.

thumbnail: BitmapSource

Uma imagem em miniatura do resultado BitmapFrame.

metadata: BitmapMetadata

Os metadados a associar a este BitmapFrame.

colorContexts: ReadOnlyCollection<ColorContext>

Os ColorContext objetos associados a este BitmapFrame.

Devoluções

BitmapFrame

A BitmapFrame de um dado BitmapSource com a miniatura especificada, BitmapMetadata, e ColorContext.

Aplica-se a

Comentários

Esta página foi útil?