Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

BitmapImage, classe

Fournit un BitmapSource spécialisé qui est optimisé pour charger des images à l'aide de XAML (eXtensible Application Markup Language).

Espace de noms :  System.Windows.Media.Imaging
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public sealed class BitmapImage : BitmapSource, 
	ISupportInitialize, IUriContext

Le type BitmapImage expose les membres suivants.

  NomDescription
Méthode publiqueBitmapImage()Initialise une nouvelle instance de la classe BitmapImage.
Méthode publiqueBitmapImage(Uri)Initialise une nouvelle instance de la classe BitmapImage à l'aide de l'Uri fourni.
Méthode publiqueBitmapImage(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.
Début

  NomDescription
Propriété publiqueBaseUriObtient ou définit une valeur qui représente l'Uri de base du contexte BitmapImage actuel.
Propriété publiqueCacheOptionObtient ou définit le BitmapCacheOption à utiliser pour cette instance de BitmapImage.
Propriété publiqueCanFreezeObtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
Propriété publiqueCreateOptionsObtient ou définit le BitmapCreateOptions d'un BitmapImage.
Propriété publiqueDecodePixelHeightObtient ou définit la hauteur, en pixels, à laquelle l'image est décodée.
Propriété publiqueDecodePixelType
Propriété publiqueDecodePixelWidthObtient ou définit la largeur, en pixels, à laquelle l'image est décodée.
Propriété publiqueDependencyObjectTypeObtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueDispatcher (Hérité de DependencyObject.)
Propriété publiqueDpiXObtient le points par pouce (ppp) horizontal de l'image.  (Hérité de BitmapSource.)
Propriété publiqueDpiYObtient le points par pouce (ppp) vertical de l'image.  (Hérité de BitmapSource.)
Propriété publiqueFormatObtient le PixelFormat natif des données bitmap. (Hérité de BitmapSource.)
Propriété publiqueHasAnimatedPropertiesObtient 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.)
Propriété publiqueHeightObtient la hauteur de l'image bitmap source en unités indépendantes du périphérique (1/96ème de pouce par unité).  (Hérité de BitmapSource.)
Propriété publiqueIsDownloadingObtient une valeur qui indique si le BitmapImage télécharge actuellement le contenu. (Substitue BitmapSource.IsDownloading.)
Propriété publiqueIsFrozenObtient une valeur qui indique si l'objet est actuellement modifiable ou pas. (Hérité de Freezable.)
Propriété publiqueIsSealedRécupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété publiqueMetadataNon pris en charge. BitmapImage ne prend pas en charge la propriété Metadata et lève un NotSupportedException. (Substitue BitmapSource.Metadata.)
Propriété publiquePaletteObtient la palette de couleurs de l'image bitmap, si spécifiée. (Hérité de BitmapSource.)
Propriété publiquePixelHeightObtient la hauteur de l'image bitmap en pixels. (Hérité de BitmapSource.)
Propriété publiquePixelWidthObtient la largeur de l'image bitmap en pixels. (Hérité de BitmapSource.)
Propriété publiqueRotationObtient ou définit l'angle auquel ce BitmapImage est pivoté.
Propriété publiqueSourceRectObtient ou définit le rectangle qui est utilisé comme source du BitmapImage.
Propriété publiqueStreamSourceObtient ou définit la source de flux du BitmapImage.
Propriété publiqueUriCachePolicyObtient ou définit une valeur qui représente la stratégie de mise en cache pour les images provenant d'une source HTTP.
Propriété publiqueUriSourceObtient ou définit la source Uri du BitmapImage.
Propriété publiqueWidthObtient la largeur de l'image bitmap en unités indépendantes du périphérique (1/96ème de pouce par unité).  (Hérité de BitmapSource.)
Début

  NomDescription
Méthode publiqueApplyAnimationClock(DependencyProperty, AnimationClock)Applique une horloge AnimationClock à la propriété DependencyProperty spécifiée. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable.)
Méthode publiqueApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)Applique une horloge AnimationClock à la propriété DependencyProperty spécifiée. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable.)
Méthode publiqueBeginAnimation(DependencyProperty, AnimationTimeline)Applique une animation à la propriété DependencyPropertyspécifiée. L'animation est démarrée à 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.)
Méthode publiqueBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)Applique une animation à la propriété DependencyPropertyspécifiée. L'animation est démarrée à 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.)
Méthode publiqueBeginInitSignale le début de l'initialisation de BitmapImage.
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publiqueClearValue(DependencyPropertyKey)Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject.)
Méthode publiqueCloneCrée un clone modifiable de ce BitmapImage, en créant des copies complètes des valeurs de cet objet.
Méthode publiqueCloneCurrentValueCrée un clone modifiable de cet objet BitmapImage, en créant des copies complètes 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.
Méthode publiqueCoerceValueForce la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
Méthode publiqueCopyPixels(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.)
Méthode publiqueCopyPixels(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.)
Méthode publiqueCopyPixels(Int32Rect, IntPtr, Int32, Int32)Copie les données de pixels de l'image bitmap dans le rectangle spécifié. (Hérité de BitmapSource.)
Méthode publiqueEndInitSignale la fin de l'initialisation de BitmapImage.
Méthode publiqueEqualsDétermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode publiqueFreeze()Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
Méthode publiqueGetAnimationBaseValueRetourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable.)
Méthode publiqueGetAsFrozenCré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.)
Méthode publiqueGetCurrentValueAsFrozenCré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.)
Méthode publiqueGetHashCodeObtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueGetLocalValueEnumeratorCré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.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueInvalidatePropertyRéévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode publiqueSetCurrentValueDéfinit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publiqueSetSource (Hérité de BitmapSource.)
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publiqueSetValue(DependencyPropertyKey, Object)Définit la valeur de proximité 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.)
Méthode protégéeShouldSerializePropertyRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.)
Méthode publiqueToString() Crée une représentation sous forme de chaîne de cet objet selon la culture actuelle. (Hérité de ImageSource.)
Méthode publiqueToString(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.)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

  NomDescription
Événement publicChangedSe produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable.)
Événement publicDecodeFailedSe 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.)
Événement publicDownloadCompletedSe produit lorsque le contenu de la bitmap a été complètement téléchargé. (Hérité de BitmapSource.)
Événement publicDownloadFailedSe produit lorsque le téléchargement du contenu de la bitmap a échoué. (Hérité de BitmapSource.)
Événement publicDownloadProgressSe produit lorsque la progression du téléchargement du contenu de la bitmap a changé. (Hérité de BitmapSource.)
Événement publicImageFailed
Événement publicImageOpened
Début

  NomDescription
Champ publicMembre statiqueCacheOptionPropertyIdentifie la propriété de dépendance CacheOption.
Champ publicMembre statiqueCreateOptionsPropertyIdentifie la propriété de dépendance CreateOptions.
Champ publicMembre statiqueDecodePixelHeightPropertyIdentifie la propriété de dépendance DecodePixelHeight.
Champ publicMembre statiqueDecodePixelTypeProperty
Champ publicMembre statiqueDecodePixelWidthPropertyIdentifie la propriété de dépendance DecodePixelWidth.
Champ publicMembre statiqueRotationPropertyIdentifie la propriété de dépendance Rotation.
Champ publicMembre statiqueSourceRectPropertyIdentifie la propriété de dépendance SourceRect.
Champ publicMembre statiqueStreamSourcePropertyIdentifie la propriété de dépendance StreamSource.
Champ publicMembre statiqueUriCachePolicyPropertyIdentifie la propriété de dépendance UriCachePolicy.
Champ publicMembre statiqueUriSourcePropertyIdentifie la propriété de dépendance UriSource.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIFormattable.ToStringMet en forme la valeur de l'instance actuelle à l'aide du format spécifié. (Hérité de ImageSource.)
Début

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

BitmapImage implémente l'interface ISupportInitialize pour optimiser l'initialisation de 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 démarré et EndInit pour signaler que l'initialisation est terminée. Après l'initialisation, les modifications de propriété sont ignorées.

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

Les exemples de code suivants montrent comment utiliser un BitmapImage dans XAML (eXtensible Application Markup Language) et du 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.
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



// 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;


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft