BitmapDecoder Classe

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.

Représente un conteneur pour des frames de bitmaps. Chaque frame de bitmap est un BitmapSource. Cette classe abstraite fournit un jeu de fonctionnalités de base pour tous les objets décodeurs dérivés.

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject

public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject

type BitmapDecoder = class
    inherit DispatcherObject

Public MustInherit Class BitmapDecoder
Inherits DispatcherObject

Héritage: Object

DispatcherObject
BitmapDecoder

Dérivé: System.Windows.Media.Imaging.BmpBitmapDecoder

System.Windows.Media.Imaging.GifBitmapDecoder

System.Windows.Media.Imaging.IconBitmapDecoder

System.Windows.Media.Imaging.JpegBitmapDecoder

System.Windows.Media.Imaging.LateBoundBitmapDecoder

Plus…

Exemples

L’exemple suivant montre comment utiliser la Create(Uri, BitmapCreateOptions, BitmapCacheOption) méthode pour créer un décodeur pour une image donnée. La première BitmapFrame de l’image est utilisée comme source d’un Image contrôle.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];

Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

L’exemple de code suivant montre comment utiliser l’élément intégré TiffBitmapDecoder pour ouvrir et décoder une bitmap TIFF (Tagged Image File Format). Le résultat BitmapSource est utilisé comme élément Source Image .


// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);

' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

Remarques

BitmapDecoder n’est pas lui-même BitmapFrame ; il s’agit plutôt d’un conteneur pour BitmapFrame les objets. Chaque BitmapFrame conteneur peut avoir des attributs différents, notamment des tailles, des résolutions ou des palettes différentes.

Sauf si un codec spécifique est sélectionné, Windows Presentation Foundation (WPF) utilise la découverte automatique au moment de l’exécution pour identifier le format d’une image et la mettre en correspondance avec le codec approprié. Ce processus de découverte permet à un codec développé par un éditeur de logiciels indépendant (ISV) d’être détectable automatiquement par le système. Pour sélectionner un codec spécifique, le codec dérivé BitmapDecoder ou BitmapEncoder, tel que la TiffBitmapDecoder classe, doit être utilisé.

Le format TIFF (Graphics Interchange Format) et le format GIF (Graphics Interchange Format) sont les seuls formats d’image implémentés qui prennent en charge plusieurs images.

Constructeurs

BitmapDecoder()

Initialise une nouvelle instance de BitmapDecoder.

Propriétés

CodecInfo	Obtient des informations qui décrivent ce codec.
ColorContexts	Obtient une valeur qui représente le profil de couleurs associé à une image bitmap, le cas échéant.
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
Frames	Obtient le contenu d’une image individuelle dans une image bitmap.
IsDownloading	Obtient une valeur qui indique si le décodeur télécharge actuellement le contenu.
Metadata	Obtient une instance de BitmapMetadata qui représente les métadonnées globales associées à cette image bitmap, si des métadonnées sont définies.
Palette	Obtient le BitmapPalette associé à ce décodeur.
Preview	Obtient un BitmapSource qui représente l’aperçu global de cette image bitmap, s’il est défini.
Thumbnail	Obtient un BitmapSource qui représente la miniature de l’image bitmap, si elle est définie.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Crée un BitmapDecoder à partir d'un Stream en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.
CreateInPlaceBitmapMetadataWriter()	Crée une instance de InPlaceBitmapMetadataWriter, qui peut être utilisée pour mettre à jour les métadonnées d’une bitmap.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Libère les ressources et exécute d’autres opérations de nettoyage avant la récupération du BitmapDecoder par la garbage collection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Convertit la valeur actuelle d'un BitmapDecoder en String.
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Événements

DownloadCompleted	Se produit quand un BitmapDecoder a fini de télécharger le contenu de la bitmap.
DownloadFailed	Se produit quand le téléchargement du contenu de la bitmap a échoué.
DownloadProgress	Se produit quand un BitmapDecoder a progressé dans le téléchargement du contenu de la bitmap.

S’applique à