BitmapFrame.Create Méthode

Référence

Définition

Espace de noms:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un nouveau BitmapFrame basé sur les arguments fournis.

Surcharges

Create(Stream)	Crée un BitmapFrame à partir d’un Stream.
Create(Uri)	Crée un BitmapFrame à partir d’un Uri.
Create(BitmapSource)	Crée un BitmapFrame à partir d’un BitmapSource.
Create(Uri, RequestCachePolicy)	Crée un BitmapFrame à partir d'un Uri donné avec le RequestCachePolicy spécifié.
Create(BitmapSource, BitmapSource)	Crée un nouveau BitmapFrame à partir d'un BitmapSource donné avec la miniature spécifiée.
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Crée un nouveau BitmapFrame à partir d'un Stream donné avec les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Crée un BitmapFrame à partir d'un Uri donné avec les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Crée un BitmapFrame à partir d'un Uri donné avec les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	Crée un BitmapFrame à partir d’un BitmapSource donné avec la miniature spécifiée, BitmapMetadata, et ColorContext.

Create(Stream)

Crée un BitmapFrame à partir d’un 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

Paramètres

bitmapStream: Stream

Stream qui est utilisé pour construire le BitmapFrame.

Retours

BitmapFrame

BitmapFrame d'un Stream donné.

Remarques

Le bitmapStream peut être fermé après la création de l’image uniquement lorsque l’option de OnLoad cache est utilisée. L’option de cache par défaut OnDemand conserve le flux jusqu’à ce que l’image soit nécessaire. Utilisez la Create(Stream, BitmapCreateOptions, BitmapCacheOption) méthode pour spécifier les options de création et de mise en cache.

S’applique à

Create(Uri)

Crée un BitmapFrame à partir d’un 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

Paramètres

bitmapUri: Uri

Uri qui identifie la source du BitmapFrame.

Retours

BitmapFrame

BitmapFrame d'un Uri donné.

Exemples

L’exemple de code suivant montre comment construire un BitmapFrame à partir d’un .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)

S’applique à

Create(BitmapSource)

Crée un BitmapFrame à partir d’un 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

Paramètres

source: BitmapSource

BitmapSource utilisé pour construire ce BitmapFrame.

Retours

BitmapFrame

BitmapFrame d'un BitmapSource donné.

S’applique à

Create(Uri, RequestCachePolicy)

Crée un BitmapFrame à partir d'un Uri donné avec le RequestCachePolicy spécifié.

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

Paramètres

bitmapUri: Uri

Emplacement de la bitmap à partir de laquelle le BitmapFrame est créé.

uriCachePolicy: RequestCachePolicy

Exigences de mise en cache pour ce BitmapFrame.

Retours

BitmapFrame

BitmapFrame d'un Uri donné avec la RequestCachePolicy spécifiée.

Remarques

Create(Uri, RequestCachePolicy) est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

S’applique à

Create(BitmapSource, BitmapSource)

Crée un nouveau BitmapFrame à partir d'un BitmapSource donné avec la miniature spécifiée.

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

Paramètres

source: BitmapSource

Source à partir de laquelle le BitmapFrame est construit.

thumbnail: BitmapSource

Image miniature du BitmapFrame obtenu.

Retours

BitmapFrame

Un BitmapFrame d'une BitmapSource donnée avec la miniature spécifiée.

S’applique à

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crée un nouveau BitmapFrame à partir d'un Stream donné avec les BitmapCreateOptions et BitmapCacheOption spécifiés.

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

Paramètres

bitmapStream: Stream

Flux à partir duquel ce BitmapFrame est construit.

createOptions: BitmapCreateOptions

Options qui sont utilisées pour créer ce BitmapFrame.

cacheOption: BitmapCacheOption

Option de cache qui est utilisée pour créer ce BitmapFrame.

Retours

BitmapFrame

Un BitmapFrame d'un Stream donné avec les BitmapCreateOptions et BitmapCacheOption spécifiées.

Remarques

Utilisez l’option OnLoad de cache si vous souhaitez fermer le bitmapStream après la création de la bitmap. L’option de cache par défaut OnDemand conserve l’accès au flux jusqu’à ce que la bitmap soit nécessaire et que le nettoyage soit géré par le garbage collector.

S’applique à

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crée un BitmapFrame à partir d'un Uri donné avec les BitmapCreateOptions et BitmapCacheOption spécifiés.

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

Paramètres

bitmapUri: Uri

Emplacement de la bitmap à partir de laquelle le BitmapFrame est créé.

createOptions: BitmapCreateOptions

Options qui sont utilisées pour créer ce BitmapFrame.

cacheOption: BitmapCacheOption

Option de cache qui est utilisée pour créer ce BitmapFrame.

Retours

BitmapFrame

Un BitmapFrame d'une Uri donnée avec les BitmapCreateOptions et BitmapCacheOption spécifiées.

S’applique à

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crée un BitmapFrame à partir d'un Uri donné avec les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.

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

Paramètres

bitmapUri: Uri

Emplacement de la bitmap à partir de laquelle le BitmapFrame est créé.

createOptions: BitmapCreateOptions

Options qui sont utilisées pour créer ce BitmapFrame.

cacheOption: BitmapCacheOption

Option de cache qui est utilisée pour créer ce BitmapFrame.

uriCachePolicy: RequestCachePolicy

Exigences de mise en cache pour ce BitmapFrame.

Retours

BitmapFrame

Un BitmapFrame d'une Uri donnée avec les BitmapCreateOptions, BitmapCacheOption, et RequestCachePolicy spécifiées.

Remarques

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

S’applique à

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

Crée un BitmapFrame à partir d’un BitmapSource donné avec la miniature spécifiée, BitmapMetadata, et 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

Paramètres

source: BitmapSource

BitmapSource utilisé pour construire ce BitmapFrame.

thumbnail: BitmapSource

Image miniature du BitmapFrame obtenu.

metadata: BitmapMetadata

Métadonnées à associer à ce BitmapFrame.

colorContexts: ReadOnlyCollection<ColorContext>

Objets ColorContext qui sont associés à ce BitmapFrame.

Retours

BitmapFrame

BitmapFrame à partir d’un BitmapSource donné avec la miniature spécifiée, BitmapMetadata, et ColorContext.

S’applique à

Partager via

BitmapFrame.Create Méthode

Définition

Surcharges

Create(Stream)

Paramètres

Retours

Remarques

S’applique à

Create(Uri)

Paramètres

Retours

Exemples

S’applique à

Create(BitmapSource)

Paramètres

Retours

S’applique à

Create(Uri, RequestCachePolicy)

Paramètres

Retours

Remarques

S’applique à

Create(BitmapSource, BitmapSource)

Paramètres

Retours

S’applique à

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Paramètres

Retours

Remarques

S’applique à

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Paramètres

Retours

S’applique à

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Paramètres

Retours

Remarques

S’applique à

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

Paramètres

Retours

S’applique à

Ressources supplémentaires