BitmapSource Classe
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.
Représente un ensemble unique et constant de pixels à une certaine taille et résolution.
public ref class BitmapSource abstract : System::Windows::Media::ImageSource[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class BitmapSource : System.Windows.Media.ImageSource[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type BitmapSource = class
inherit ImageSource
interface DUCE.IResourcePublic MustInherit Class BitmapSource
Inherits ImageSource- Héritage
- Dérivé
- Attributs
Exemples
L’exemple de code suivant montre comment créer et BitmapSource l’utiliser comme source d’un Image contrôle.
// Define parameters used to create the BitmapSource.
PixelFormat pf = PixelFormats.Bgr32;
int width = 200;
int height = 200;
int rawStride = (width * pf.BitsPerPixel + 7) / 8;
byte[] rawImage = new byte[rawStride * height];
// Initialize the image with data.
Random value = new Random();
value.NextBytes(rawImage);
// Create a BitmapSource.
BitmapSource bitmap = BitmapSource.Create(width, height,
96, 96, pf, null,
rawImage, rawStride);
// Create an image element;
Image myImage = new Image();
myImage.Width = 200;
// Set image source.
myImage.Source = bitmap;
' Define parameters used to create the BitmapSource.
Dim pf As PixelFormat = PixelFormats.Bgr32
Dim width As Integer = 200
Dim height As Integer = 200
Dim rawStride As Integer = CType((width * pf.BitsPerPixel + 7) / 8, Integer)
Dim rawImage(rawStride * height) As Byte
' Initialize the image with data.
Dim value As New Random()
value.NextBytes(rawImage)
' Create a BitmapSource.
Dim bitmap As BitmapSource = BitmapSource.Create(width, height, 96, 96, pf, Nothing, rawImage, rawStride)
' Create an image element;
Dim myImage As New Image()
myImage.Width = 200
' Set image source.
myImage.Source = bitmap
L’exemple de code suivant utilise une BitmapSource classe dérivée, BitmapImagepour créer une bitmap à partir d’un fichier image et l’utiliser comme source d’un Image contrôle.
// 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
BitmapSource est le bloc de construction de base du pipeline d’imagerie Windows Presentation Foundation (WPF), représentant conceptuellement un ensemble unique et constant de pixels à une certaine taille et résolution. Il BitmapSource peut s’agir d’un cadre unique dans un fichier image fourni par un décodeur, ou il peut être le résultat d’une transformation qui fonctionne sur un BitmapSource de ses propres fichiers. BitmapSource n’est pas utilisé pour représenter une image multi-images ou une animation.
Windows Presentation Foundation (WPF) prend en charge en mode natif la compression et la décompression de bitmap (BMP), le format d’échange graphique (GIF), le groupe d’experts photographiques conjoints (JPEG), les images PNG (Portable Network Graphics) et les images TIFF (Tagged Image File Format).
Pour les scénarios de décodage bitmap, BitmapSource utilise la découverte automatique de codecs, basée sur les codecs installés sur le système de l’utilisateur.
La hauteur maximale et la largeur d’une image sont de 2^16 pixels à 32 bits par canal * 4 canaux. La taille maximale d’un BitmapSource est de 2^32 octets (64 gigaoctets) et la taille maximale de l’image est de quatre gigapixels. La taille minimale de l’image est 1x1.
Constructeurs
| Nom | Description |
|---|---|
| BitmapSource() |
Initialise une nouvelle instance de la classe BitmapSource. |
Propriétés
| Nom | Description |
|---|---|
| CanFreeze |
Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable) |
| DependencyObjectType |
Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject) |
| Dispatcher |
Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject) |
| DpiX |
Obtient les points horizontaux par pouce (ppp) de l’image. |
| DpiY |
Obtient les points verticaux par pouce (ppp) de l’image. |
| Format |
Obtient le natif PixelFormat des données bitmap. |
| HasAnimatedProperties |
Obtient une valeur qui indique si un ou plusieurs AnimationClock objets sont associés à l’une des propriétés de dépendance de cet objet. (Hérité de Animatable) |
| Height |
Obtient la hauteur de la bitmap source dans les unités indépendantes de l’appareil (1/96e pouce par unité). |
| IsDownloading |
Obtient une valeur qui indique si le BitmapSource contenu est en cours de téléchargement. |
| IsFrozen |
Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable) |
| IsSealed |
Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject) |
| Metadata |
Obtient les métadonnées associées à cette image bitmap. |
| Palette |
Obtient la palette de couleurs de la bitmap, si elle est spécifiée. |
| PixelHeight |
Obtient la hauteur de la bitmap en pixels. |
| PixelWidth |
Obtient la largeur de la bitmap en pixels. |
| Width |
Obtient la largeur de la bitmap en unités indépendantes de l’appareil (1/96e pouce par unité). |
Méthodes
| Nom | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, la propriété HandoffBehavior spécifiée est utilisée. (Hérité de Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, celle-ci HandoffBehavior est utilisée. (Hérité de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable) |
| CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
| CheckIfSiteOfOrigin() |
Vérifie si le contenu source bitmap provient d’un site d’origine connu. Cette méthode est utilisée pour vous assurer que les opérations de copie de pixels sont sécurisées. |
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 un DependencyPropertyKey. (Hérité de DependencyObject) |
| Clone() |
Crée un clone modifiable de ce BitmapSourcefichier, en effectuant des copies approfondies des valeurs de cet objet. Lors de 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 (mais elles peuvent ne plus être résolues), mais pas les animations ni leurs valeurs actuelles. |
| CloneCore(Freezable) |
Rend cette instance une copie approfondie du fichier spécifié BitmapSource. Lors de 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 (mais elles peuvent ne plus être résolues), mais pas les animations ni leurs valeurs actuelles. |
| CloneCurrentValue() |
Crée un clone modifiable de cet BitmapSource objet, effectuant des copies approfondies des valeurs actuelles de cet objet. Les références de ressources, les liaisons de données et les animations ne sont pas copiées, mais leurs valeurs actuelles sont. |
| CloneCurrentValueCore(Freezable) |
Rend cette instance une copie approfondie modifiable de l’élément spécifié BitmapSource à l’aide des valeurs de propriété actuelles. Les références de ressources, les liaisons de données et les animations ne sont pas copiées, mais leurs valeurs actuelles sont. |
| CoerceValue(DependencyProperty) |
Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject) |
| CopyPixels(Array, Int32, Int32) |
Copie les données de pixel bitmap dans un tableau de pixels avec la progression spécifiée, en commençant à l’offset spécifié. |
| CopyPixels(Int32Rect, Array, Int32, Int32) |
Copie les données de pixel bitmap dans le rectangle spécifié dans un tableau de pixels dont la progression spécifiée commence au décalage spécifié. |
| CopyPixels(Int32Rect, IntPtr, Int32, Int32) |
Copie les données de pixel bitmap dans le rectangle spécifié. |
| Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32) |
Crée un nouveau BitmapSource tableau de pixels. |
| Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32) |
Crée un BitmapSource nouveau tableau de pixels stockés dans une mémoire non managée. |
| CreateInstance() |
Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable) |
| CreateInstanceCore() |
En cas d’implémentation dans une classe dérivée, crée une nouvelle instance de la Freezable classe dérivée. (Hérité de Freezable) |
| Equals(Object) |
Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject) |
| Freeze() |
Rend l’objet actuel non modifiable et définit sa IsFrozen propriété sur |
| FreezeCore(Boolean) |
Rend une instance de BitmapSource ou une classe dérivée immuable. |
| GetAnimationBaseValue(DependencyProperty) |
Retourne la valeur non animée de l’objet spécifié DependencyProperty. (Hérité de Animatable) |
| GetAsFrozen() |
Crée une copie figée des valeurs de Freezablepropriété de base (non animées). É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) |
Fait de cette instance un clone de l’objet spécifié BitmapSource . |
| GetCurrentValueAsFrozen() |
Crée une copie figée de l’utilisation Freezable 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) |
Fait de cette instance un clone figé du fichier spécifié BitmapSource. Les références de ressources, les liaisons de données et les animations ne sont pas copiées, mais leurs valeurs actuelles sont. |
| 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 la 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) |
Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnChanged() |
Appelé lorsque l’objet actuel Freezable est modifié. (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) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui vient d’être défini. (Hérité de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Remplace l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) l’appel de tous Changed les gestionnaires en réponse à une propriété de dépendance modifiée de type Freezable. (Hérité de Freezable) |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject) |
| ReadPreamble() |
Garantit l’accès Freezable à partir d’un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API qui lit 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 source de valeur. (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 en fonction de 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 passage. Si le fournisseur est |
| VerifyAccess() |
Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
| WritePostscript() |
Déclenche l’événement Changed pour la Freezable méthode et appelle sa OnChanged() méthode. Les classes dérivées Freezable de doivent appeler cette méthode à la fin de toute API qui modifie les 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 l’objet Freezable n’est pas figé et qu’il est accessible à partir d’un contexte de threading valide. Freezable Les hériteurs doivent appeler cette méthode au début de toute API qui écrit dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable) |
Événements
| Nom | Description |
|---|---|
| Changed |
Se produit lorsque l’objet Freezable qu’il contient est modifié. (Hérité de Freezable) |
| DecodeFailed |
Se produit lorsque l’image ne parvient pas à se charger, en raison d’un en-tête d’image endommagé. |
| DownloadCompleted |
Se produit lorsque le contenu bitmap a été entièrement téléchargé. |
| DownloadFailed |
Se produit lorsque le contenu bitmap n’a pas pu être téléchargé. |
| DownloadProgress |
Se produit lorsque la progression du téléchargement du contenu bitmap a changé. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Met en forme la valeur de l’instance actuelle à l’aide du format spécifié. (Hérité de ImageSource) |
S’applique à
Voir aussi
- BitmapImage
- composant d’imagerie Microsoft Windows
- IWCBitmapSource