Partager via


BitmapDecoder Classe

Définition

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
BitmapDecoder
Dérivé

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 à

Voir aussi