BitmapFrame.Create Méthode
Définition
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 une nouvelle BitmapFrame basée sur les arguments fournis.
Surcharges
Create(Stream)
Crée un nouveau BitmapFrame à partir d’un élément donné 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
Utilisé Stream pour construire le BitmapFrame.
Retours
A BitmapFrame d’un donné Stream.
Remarques
La bitmapStream valeur peut être fermée une fois le frame créé uniquement lorsque l’option de OnLoad cache est utilisée. L’option de cache par défaut OnDemand conserve le flux jusqu’à ce que le frame soit nécessaire. Utilisez la Create(Stream, BitmapCreateOptions, BitmapCacheOption) méthode pour spécifier les options de création et de cache.
S’applique à
Create(Uri)
Crée un nouveau BitmapFrame à partir d’un élément donné 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
Qui Uri identifie la source du BitmapFrame.
Retours
A BitmapFrame d’un donné Uri.
Exemples
L’exemple de code suivant montre comment construire un à BitmapFrame partir d’un donné 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 nouveau BitmapFrame à partir d’un élément donné 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
Utilisé BitmapSource pour construire ce BitmapFrame.
Retours
A BitmapFrame d’un donné BitmapSource.
S’applique à
Create(Uri, RequestCachePolicy)
Crée un élément BitmapFrame à partir d’un donné Uri avec le fichier spécifié 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
Paramètres
- bitmapUri
- Uri
Emplacement de la bitmap à partir de laquelle le BitmapFrame fichier est créé.
- uriCachePolicy
- RequestCachePolicy
Conditions de mise en cache requises pour cela BitmapFrame.
Retours
A BitmapFrame d’un donné Uri avec le spécifié RequestCachePolicy.
Remarques
Create(Uri, RequestCachePolicy) est introduit dans .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.
S’applique à
Create(BitmapSource, BitmapSource)
Crée une nouvelle BitmapFrame à partir d’une donnée BitmapSource 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 fichier est construit.
- thumbnail
- BitmapSource
Image miniature du résultat BitmapFrame.
Retours
A BitmapFrame partir d’une donnée BitmapSource avec la miniature spécifiée.
S’applique à
Create(Stream, BitmapCreateOptions, BitmapCacheOption)
Crée un nouveau BitmapFrame à partir d’un donné Stream avec les données spécifiées BitmapCreateOptions et 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
Paramètres
- bitmapStream
- Stream
Flux à partir duquel il BitmapFrame est construit.
- createOptions
- BitmapCreateOptions
Options utilisées pour créer ce BitmapFramefichier .
- cacheOption
- BitmapCacheOption
Option de cache utilisée pour créer ce BitmapFramefichier .
Retours
A BitmapFrame d’un donné Stream avec les données spécifiées BitmapCreateOptions et BitmapCacheOption.
Remarques
Utilisez l’option de OnLoad cache si vous souhaitez fermer l’image bitmapStream bitmap 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 élément à partir d’un donné Uri avec les données spécifiées BitmapCreateOptions et 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
Paramètres
- bitmapUri
- Uri
Emplacement de la bitmap à partir de laquelle le BitmapFrame fichier est créé.
- createOptions
- BitmapCreateOptions
Options utilisées pour créer ce BitmapFramefichier .
- cacheOption
- BitmapCacheOption
Option de cache utilisée pour créer ce BitmapFramefichier .
Retours
A BitmapFrame d’un donné Uri avec le spécifié BitmapCreateOptions, et BitmapCacheOption.
S’applique à
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)
Crée un BitmapFrame élément à partir d’un donné Uri avec le BitmapCreateOptions, BitmapCacheOptionet 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
Paramètres
- bitmapUri
- Uri
Emplacement de la bitmap à partir de laquelle le BitmapFrame fichier est créé.
- createOptions
- BitmapCreateOptions
Options utilisées pour créer ce BitmapFramefichier .
- cacheOption
- BitmapCacheOption
Option de cache utilisée pour créer ce BitmapFramefichier .
- uriCachePolicy
- RequestCachePolicy
Conditions de mise en cache requises pour cela BitmapFrame.
Retours
A BitmapFrame d’un donné Uri avec le BitmapCreateOptions, BitmapCacheOptionet RequestCachePolicy.
Remarques
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) est introduit dans .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 nouveau BitmapFrame à partir d’une donnée BitmapSource avec la miniature spécifiée, BitmapMetadataet 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
Utilisé BitmapSource pour construire ce BitmapFrame.
- thumbnail
- BitmapSource
Image miniature du résultat BitmapFrame.
- metadata
- BitmapMetadata
Métadonnées à associer à ce BitmapFrame.
- colorContexts
- ReadOnlyCollection<ColorContext>
Objets ColorContext associés à ce BitmapFrame.
Retours
A BitmapFrame d’un donné BitmapSource avec la miniature spécifiée, BitmapMetadataet ColorContext.