BitmapImage Classe

Définition

Fournit une BitmapSource spécialisée qui est optimisée pour le chargement des images avec XAML (Extensible Application Markup Language).

public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContext
public sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContext
type BitmapImage = class
    inherit BitmapSource
    interface ISupportInitialize
    interface IUriContext
Public NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext
Héritage
Implémente

Exemples

Les exemples de code suivants montrent comment utiliser un BitmapImage dans XAML (Extensible Application Markup Language) et le code.

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;
' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

Remarques

BitmapImage existe principalement pour prendre en charge la syntaxe XAML (Extensible Application Markup Language) et introduit des propriétés supplémentaires pour le chargement bitmap qui ne sont pas définies par BitmapSource.

BitmapImage implémente l’interface ISupportInitialize pour optimiser l’initialisation sur plusieurs propriétés. Les modifications de propriété ne peuvent se produire que lors de l’initialisation de l’objet. Appelez BeginInit pour signaler que l’initialisation a commencé et EndInit pour signaler que l’initialisation est terminée. Après l’initialisation, les modifications de propriété sont ignorées.

BitmapImage les objets créés à l’aide du BitmapImage constructeur sont automatiquement initialisés et les modifications de propriété sont ignorées.

Constructeurs

BitmapImage()

Initialise une nouvelle instance de la classe BitmapImage.

BitmapImage(Uri)

Initialise une nouvelle instance de la classe BitmapImage à l'aide de l'Uri fourni.

BitmapImage(Uri, RequestCachePolicy)

Initialise une nouvelle instance de la classe BitmapImage avec une image dont la source est une Uri et qui est mise en cache selon la RequestCachePolicy fournie.

Champs

CacheOptionProperty

Identifie la propriété de dépendance CacheOption.

CreateOptionsProperty

Identifie la propriété de dépendance CreateOptions.

DecodePixelHeightProperty

Identifie la propriété de dépendance DecodePixelHeight.

DecodePixelWidthProperty

Identifie la propriété de dépendance DecodePixelWidth.

RotationProperty

Identifie la propriété de dépendance Rotation.

SourceRectProperty

Identifie la propriété de dépendance SourceRect.

StreamSourceProperty

Identifie la propriété de dépendance StreamSource.

UriCachePolicyProperty

Identifie la propriété de dépendance UriCachePolicy.

UriSourceProperty

Identifie la propriété de dépendance UriSource.

Propriétés

BaseUri

Obtient ou définit une valeur qui représente l'Uri de base du contexte BitmapImage actuel.

CacheOption

Obtient ou définit le BitmapCacheOption à utiliser pour cette instance de BitmapImage.

CanFreeze

Obtient une valeur qui indique si l’objet peut être rendu non modifiable.

(Hérité de Freezable)
CreateOptions

Obtient ou définit le BitmapCreateOptions pour un BitmapImage.

DecodePixelHeight

Obtient ou définit la hauteur, en pixels, à laquelle l’image est décodée.

DecodePixelWidth

Obtient ou définit la largeur, en pixels, à laquelle l’image est décodée.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.

(Hérité de DispatcherObject)
DpiX

Obtient les points horizontaux par pouce (ppp) de l’image.

(Hérité de BitmapSource)
DpiY

Obtient les points verticaux par pouce (ppp) de l’image.

(Hérité de BitmapSource)
Format

Obtient le PixelFormat natif des données bitmap.

(Hérité de BitmapSource)
HasAnimatedProperties

Obtient une valeur qui indique si un ou plusieurs objets AnimationClock sont associés à l'une ou l'autre des propriétés de dépendance de cet objet.

(Hérité de Animatable)
Height

Obtient la hauteur de la bitmap source en unités indépendantes de l’appareil (1/96e pouce par unité).

(Hérité de BitmapSource)
IsDownloading

Obtient une valeur qui indique si le BitmapImage télécharge actuellement le contenu.

IsFrozen

Obtient une valeur qui indique si l’objet est actuellement modifiable.

(Hérité de Freezable)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).

(Hérité de DependencyObject)
Metadata

Non pris en charge. BitmapImage ne prend pas en charge la propriété Metadata et lève un NotSupportedException.

Palette

Obtient la palette de couleurs de l'image bitmap, si spécifiée.

(Hérité de BitmapSource)
PixelHeight

Obtient la hauteur de l'image bitmap en pixels.

(Hérité de BitmapSource)
PixelWidth

Obtient la largeur de l'image bitmap en pixels.

(Hérité de BitmapSource)
Rotation

Obtient ou définit l'angle auquel ce BitmapImage est pivoté.

SourceRect

Obtient ou définit le rectangle qui est utilisé comme source du BitmapImage.

StreamSource

Obtient ou définit la source de flux du BitmapImage.

UriCachePolicy

Obtient ou définit une valeur qui représente la stratégie de mise en cache pour les images provenant d'une source HTTP.

UriSource

Obtient ou définit la source Uri du BitmapImage.

Width

Obtient la largeur de la bitmap en unités indépendantes de l’appareil (1/96e pouce par unité).

(Hérité de BitmapSource)

Méthodes

ApplyAnimationClock(DependencyProperty, AnimationClock)

Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.

(Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.

(Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.

(Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.

(Hérité de Animatable)
BeginInit()

Signale le début de l'initialisation de BitmapImage.

CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.

(Hérité de DispatcherObject)
CheckIfSiteOfOrigin()

Vérifie si le contenu de la source bitmap provient d’un site d’origine connu. Cette méthode est utilisée pour s’assurer que les opérations de copie des pixels sont sûres.

(Hérité de BitmapSource)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey.

(Hérité de DependencyObject)
Clone()

Crée un clone modifiable de ce BitmapImage, en créant des copies complètes des valeurs de cet objet.

CloneCore(Freezable)

Convertit cette instance en copie complète de l’objet BitmapSource spécifié. Pendant la copie des propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (qui risquent toutefois de ne plus pouvoir se résoudre), mais pas les animations ni leurs valeurs actuelles.

(Hérité de BitmapSource)
CloneCurrentValue()

Crée un clone modifiable de cet objet BitmapImage, en effectuant une copie complète des valeurs actuelles de cet objet. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.

CloneCurrentValueCore(Freezable)

Convertit cette instance en copie complète modifiable de l’objet BitmapSource spécifié à l’aide des valeurs de propriété actuelles. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.

(Hérité de BitmapSource)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.

(Hérité de DependencyObject)
CopyPixels(Array, Int32, Int32)

Copie les données de pixels de l'image bitmap dans un tableau de pixels avec la largeur de numérisation spécifiée, en commençant à l'offset spécifié.

(Hérité de BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)

Copie les données de pixels de l'image bitmap dans le rectangle indiqué dans un tableau de pixels avec la largeur de numérisation spécifiée, en commençant à l'offset spécifié.

(Hérité de BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)

Copie les données de pixels de l’image bitmap dans le rectangle spécifié.

(Hérité de BitmapSource)
CreateInstance()

Initialise une nouvelle instance de la classe Freezable.

(Hérité de Freezable)
CreateInstanceCore()

Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable.

(Hérité de Freezable)
EndInit()

Signale la fin de l'initialisation de BitmapImage.

Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.

(Hérité de DependencyObject)
Freeze()

Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true.

(Hérité de Freezable)
FreezeCore(Boolean)

Rend une instance de BitmapSource ou une classe dérivée immuable.

(Hérité de BitmapSource)
GetAnimationBaseValue(DependencyProperty)

Retourne la valeur non animée de la propriété DependencyProperty spécifiée.

(Hérité de Animatable)
GetAsFrozen()

Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.

(Hérité de Freezable)
GetAsFrozenCore(Freezable)

Convertit cette instance en un clone de l’objet BitmapSource spécifié.

(Hérité de BitmapSource)
GetCurrentValueAsFrozen()

Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.

(Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convertit cette instance en clone figé du BitmapSource spécifié. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.

(Hérité de BitmapSource)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.

(Hérité de DependencyObject)
GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnChanged()

Appelé lorsque l’objet Freezable actuel est modifié.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.

(Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable.

(Hérité de Freezable)
ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.

(Hérité de DependencyObject)
ReadPreamble()

Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance.

(Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.

(Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.

(Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.

(Hérité de DependencyObject)
ToString()

Crée une représentation sous forme de chaîne de cet objet selon la culture actuelle.

(Hérité de ImageSource)
ToString(IFormatProvider)

Crée une représentation sous forme de chaîne de cet objet en fonction du IFormatProvider passé. Si le fournisseur est null, le CurrentCulture est utilisé.

(Hérité de ImageSource)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.

(Hérité de DispatcherObject)
WritePostscript()

Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged(). Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance.

(Hérité de Freezable)
WritePreamble()

Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant dans les membres de données qui ne sont pas des propriétés de dépendance.

(Hérité de Freezable)

Événements

Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié.

(Hérité de Freezable)
DecodeFailed

Se produit en cas d'échec du téléchargement de l'image, à cause d'un en-tête d'image corrompu.

(Hérité de BitmapSource)
DownloadCompleted

Se produit lorsque le contenu de la bitmap a été complètement téléchargé.

(Hérité de BitmapSource)
DownloadFailed

Se produit lorsque le téléchargement du contenu de la bitmap a échoué.

(Hérité de BitmapSource)
DownloadProgress

Se produit lorsque la progression du téléchargement du contenu de la bitmap a changé.

(Hérité de BitmapSource)

Implémentations d’interfaces explicites

IFormattable.ToString(String, IFormatProvider)

Met en forme la valeur de l’instance actuelle en utilisant le format spécifié.

(Hérité de ImageSource)

S’applique à

Voir aussi