BitmapImage Klas

Definitie

Biedt een gespecialiseerd dat BitmapSource is geoptimaliseerd voor het laden van afbeeldingen met behulp van Extensible Application Markup Language (XAML).

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
Overname
Implementeringen

Voorbeelden

In de volgende codevoorbeelden ziet u hoe u een BitmapImage in Extensible Application Markup Language (XAML) en code gebruikt.

<!-- 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

Opmerkingen

BitmapImage bestaat voornamelijk ter ondersteuning van de syntaxis van Extensible Application Markup Language (XAML) en introduceert aanvullende eigenschappen voor het laden van bitmaps die niet zijn gedefinieerd door BitmapSource.

BitmapImage implementeert de ISupportInitialize interface om initialisatie op meerdere eigenschappen te optimaliseren. Wijzigingen in eigenschappen kunnen alleen optreden tijdens het initialiseren van objecten. Oproep BeginInit om aan te geven dat initialisatie is begonnen en EndInit om aan te geven dat initialisatie is voltooid. Na de initialisatie worden eigenschapswijzigingen genegeerd.

BitmapImage objecten die met de BitmapImage constructor worden gemaakt, worden automatisch geïnitialiseerd en eigenschapswijzigingen worden genegeerd.

Constructors

Name Description
BitmapImage()

Initialiseert een nieuw exemplaar van de BitmapImage klasse.

BitmapImage(Uri, RequestCachePolicy)

Initialiseert een nieuw exemplaar van de klasse met een installatiekopieën waarvan de BitmapImage bron een Uri, en wordt in de cache opgeslagen volgens de opgegeven RequestCachePolicy.

BitmapImage(Uri)

Initialiseert een nieuw exemplaar van de BitmapImage klasse met behulp van de opgegeven Uri.

Velden

Name Description
CacheOptionProperty

Identificeert de CacheOption afhankelijkheidseigenschap.

CreateOptionsProperty

Identificeert de CreateOptions afhankelijkheidseigenschap.

DecodePixelHeightProperty

Identificeert de DecodePixelHeight afhankelijkheidseigenschap.

DecodePixelWidthProperty

Identificeert de DecodePixelWidth afhankelijkheidseigenschap.

RotationProperty

Identificeert de Rotation afhankelijkheidseigenschap.

SourceRectProperty

Identificeert de SourceRect afhankelijkheidseigenschap.

StreamSourceProperty

Identificeert de StreamSource afhankelijkheidseigenschap.

UriCachePolicyProperty

Identificeert de UriCachePolicy afhankelijkheidseigenschap.

UriSourceProperty

Identificeert de UriSource afhankelijkheidseigenschap.

Eigenschappen

Name Description
BaseUri

Hiermee wordt een waarde opgehaald of ingesteld die de basis Uri van de huidige BitmapImage context vertegenwoordigt.

CacheOption

Hiermee wordt het BitmapCacheOption te gebruiken voor dit exemplaar van BitmapImage.

CanFreeze

Hiermee wordt een waarde opgehaald die aangeeft of het object onmodieerbaar kan worden gemaakt.

(Overgenomen van Freezable)
CreateOptions

Haalt of stelt de BitmapCreateOptions voor een BitmapImage.

DecodePixelHeight

Hiermee wordt de hoogte in pixels opgehaald of ingesteld waarop de afbeelding wordt gedecodeerd.

DecodePixelWidth

Hiermee wordt de breedte in pixels opgehaald of ingesteld waarop de afbeelding wordt gedecodeerd.

DependencyObjectType

Hiermee haalt u het DependencyObjectType CLR-type van dit exemplaar op.

(Overgenomen van DependencyObject)
Dispatcher

Hiermee wordt de Dispatcher aan dit DispatcherObject gekoppelde bestand.

(Overgenomen van DispatcherObject)
DpiX

Hiermee haalt u de horizontale puntjes per inch (dpi) van de afbeelding op.

(Overgenomen van BitmapSource)
DpiY

Hiermee haalt u de verticale puntjes per inch (dpi) van de afbeelding op.

(Overgenomen van BitmapSource)
Format

Hiermee haalt u de systeemeigen gegevens PixelFormat op van de bitmapgegevens.

(Overgenomen van BitmapSource)
HasAnimatedProperties

Hiermee wordt een waarde opgehaald die aangeeft of een of meer AnimationClock objecten zijn gekoppeld aan een van de afhankelijkheidseigenschappen van dit object.

(Overgenomen van Animatable)
Height

Hiermee haalt u de hoogte van de bron bitmap op in apparaatonafhankelijke eenheden (1/96e inch per eenheid).

(Overgenomen van BitmapSource)
IsDownloading

Hiermee wordt een waarde opgehaald die aangeeft of de BitmapImage inhoud momenteel wordt gedownload.

IsFrozen

Hiermee wordt een waarde opgehaald die aangeeft of het object momenteel kan worden gewijzigd.

(Overgenomen van Freezable)
IsSealed

Hiermee wordt een waarde opgehaald die aangeeft of dit exemplaar momenteel is verzegeld (alleen-lezen).

(Overgenomen van DependencyObject)
Metadata

Wordt niet ondersteund. BitmapImage biedt geen ondersteuning voor de Metadata eigenschap en zal een NotSupportedException.

Palette

Hiermee haalt u het kleurenpalet van de bitmap op, als er een is opgegeven.

(Overgenomen van BitmapSource)
PixelHeight

Hiermee haalt u de hoogte van de bitmap in pixels op.

(Overgenomen van BitmapSource)
PixelWidth

Hiermee wordt de breedte van de bitmap in pixels opgeslagen.

(Overgenomen van BitmapSource)
Rotation

Hiermee haalt u de hoek op waarop deze wordt gedraaid of stelt u deze BitmapImage in.

SourceRect

Hiermee haalt u de rechthoek op die wordt gebruikt als de bron van de BitmapImage.

StreamSource

Hiermee haalt of stelt u de stroombron van de BitmapImage.

UriCachePolicy

Hiermee wordt een waarde opgehaald of ingesteld die het cachebeleid vertegenwoordigt voor afbeeldingen die afkomstig zijn van een HTTP-bron.

UriSource

Hiermee wordt de Uri bron van de BitmapImage.

Width

Hiermee haalt u de breedte van de bitmap op in apparaatonafhankelijke eenheden (1/96e inch per eenheid).

(Overgenomen van BitmapSource)

Methoden

Name Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Hiermee wordt een AnimationClock op de opgegeven DependencyPropertywaarde toegepast. Als de eigenschap al is geanimeerd, wordt de opgegeven HandoffBehavior waarde gebruikt.

(Overgenomen van Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Hiermee wordt een AnimationClock op de opgegeven DependencyPropertywaarde toegepast. Als de eigenschap al is geanimeerd, wordt het SnapshotAndReplace handoff-gedrag gebruikt.

(Overgenomen van Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Hiermee past u een animatie toe op de opgegeven DependencyProperty. De animatie wordt gestart wanneer het volgende frame wordt weergegeven. Als de opgegeven eigenschap al is geanimeerd, wordt de opgegeven HandoffBehavior gebruikt.

(Overgenomen van Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Hiermee past u een animatie toe op de opgegeven DependencyProperty. De animatie wordt gestart wanneer het volgende frame wordt weergegeven. Als de opgegeven eigenschap al is geanimeerd, wordt het SnapshotAndReplace handoff-gedrag gebruikt.

(Overgenomen van Animatable)
BeginInit()

Geeft het begin van de BitmapImage initialisatie aan.

CheckAccess()

Bepaalt of de aanroepende thread toegang heeft tot dit DispatcherObject.

(Overgenomen van DispatcherObject)
CheckIfSiteOfOrigin()

Controleert of de bitmapbroninhoud afkomstig is van een bekende site van oorsprong. Deze methode wordt gebruikt om ervoor te zorgen dat pixelkopieerbewerkingen veilig zijn.

(Overgenomen van BitmapSource)
ClearValue(DependencyProperty)

Hiermee wist u de lokale waarde van een eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyProperty id.

(Overgenomen van DependencyObject)
ClearValue(DependencyPropertyKey)

Hiermee wist u de lokale waarde van een alleen-lezen eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyPropertyKey.

(Overgenomen van DependencyObject)
Clone()

Hiermee maakt u een wijzigbare kloon van dit BitmapImageobject, waardoor diepe kopieën van de waarden van dit object worden gemaakt.

CloneCore(Freezable)

Maakt dit exemplaar een diepe kopie van de opgegeven BitmapSource. Bij het kopiëren van afhankelijkheidseigenschappen kopieert deze methode bronverwijzingen en gegevensbindingen (maar ze kunnen deze mogelijk niet meer oplossen) maar niet animaties of hun huidige waarden.

(Overgenomen van BitmapSource)
CloneCurrentValue()

Hiermee maakt u een wijzigbare kloon van dit BitmapImage object, waardoor diepe kopieën worden gemaakt van de huidige waarden van dit object. Resourceverwijzingen, gegevensbindingen en animaties worden niet gekopieerd, maar de huidige waarden zijn.

CloneCurrentValueCore(Freezable)

Maakt dit exemplaar een wijzigbare diepe kopie van de opgegeven BitmapSource met behulp van huidige eigenschapswaarden. Resourceverwijzingen, gegevensbindingen en animaties worden niet gekopieerd, maar de huidige waarden zijn.

(Overgenomen van BitmapSource)
CoerceValue(DependencyProperty)

Hiermee wordt de waarde van de opgegeven afhankelijkheidseigenschap gecodeerd. Dit wordt bereikt door een CoerceValueCallback functie aan te roepen die is opgegeven in eigenschapsmetagegevens voor de afhankelijkheidseigenschap, zoals deze bestaat bij het aanroepen DependencyObject.

(Overgenomen van DependencyObject)
CopyPixels(Array, Int32, Int32)

Kopieert de bitmap pixelgegevens naar een matrix van pixels met de opgegeven stride, beginnend bij de opgegeven offset.

(Overgenomen van BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)

Kopieert de bitmap pixelgegevens binnen de opgegeven rechthoek naar een matrix van pixels met de opgegeven stride vanaf de opgegeven offset.

(Overgenomen van BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)

Kopieert de bitmap pixelgegevens binnen de opgegeven rechthoek.

(Overgenomen van BitmapSource)
CreateInstance()

Initialiseert een nieuw exemplaar van de Freezable klasse.

(Overgenomen van Freezable)
CreateInstanceCore()

Wanneer deze wordt geïmplementeerd in een afgeleide klasse, maakt u een nieuw exemplaar van de Freezable afgeleide klasse.

(Overgenomen van Freezable)
EndInit()

Geeft het einde van de BitmapImage initialisatie aan.

Equals(Object)

Bepaalt of een opgegeven DependencyObject gelijk is aan de huidige DependencyObject.

(Overgenomen van DependencyObject)
Freeze()

Maakt het huidige object onmodifieerbaar en stelt de IsFrozen eigenschap ervan in op true.

(Overgenomen van Freezable)
FreezeCore(Boolean)

Maakt een exemplaar van BitmapSource of een afgeleide klasse onveranderbaar.

(Overgenomen van BitmapSource)
GetAnimationBaseValue(DependencyProperty)

Retourneert de niet-geanimeerde waarde van de opgegeven DependencyProperty.

(Overgenomen van Animatable)
GetAsFrozen()

Hiermee maakt u een geblokkeerde kopie van de Freezableeigenschapswaarden met basiswaarden (niet-geanimeerd). Omdat de kopie is geblokkeerd, worden alle geblokkeerde subobjecten gekopieerd met verwijzing.

(Overgenomen van Freezable)
GetAsFrozenCore(Freezable)

Hiermee wordt dit exemplaar een kloon van het opgegeven BitmapSource object.

(Overgenomen van BitmapSource)
GetCurrentValueAsFrozen()

Hiermee maakt u een geblokkeerde kopie van het Freezable gebruik van de huidige eigenschapswaarden. Omdat de kopie is geblokkeerd, worden alle geblokkeerde subobjecten gekopieerd met verwijzing.

(Overgenomen van Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Hiermee wordt deze instantie een geblokkeerde kloon van de opgegeven BitmapSource. Resourceverwijzingen, gegevensbindingen en animaties worden niet gekopieerd, maar de huidige waarden zijn.

(Overgenomen van BitmapSource)
GetHashCode()

Hiermee haalt u een hashcode op.DependencyObject

(Overgenomen van DependencyObject)
GetLocalValueEnumerator()

Hiermee maakt u een gespecialiseerde enumerator om te bepalen welke afhankelijkheidseigenschappen lokaal waarden hebben ingesteld.DependencyObject

(Overgenomen van DependencyObject)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetValue(DependencyProperty)

Retourneert de huidige effectieve waarde van een afhankelijkheidseigenschap op dit exemplaar van een DependencyObject.

(Overgenomen van DependencyObject)
InvalidateProperty(DependencyProperty)

Evalueert de effectieve waarde voor de opgegeven afhankelijkheidseigenschap opnieuw.

(Overgenomen van DependencyObject)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnChanged()

Aangeroepen wanneer het huidige Freezable object wordt gewijzigd.

(Overgenomen van Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dit lid ondersteunt de Windows Presentation Foundation -infrastructuur (WPF) en is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt.

(Overgenomen van Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zorgt ervoor dat de juiste contextpointers tot stand worden gebracht voor een DependencyObjectType gegevenslid dat zojuist is ingesteld.

(Overgenomen van Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Overschrijft de DependencyObject implementatie van het aanroepen OnPropertyChanged(DependencyPropertyChangedEventArgs) van Changed handlers als reactie op een veranderende afhankelijkheidseigenschap van het typeFreezable.

(Overgenomen van Freezable)
ReadLocalValue(DependencyProperty)

Retourneert de lokale waarde van een afhankelijkheidseigenschap, als deze bestaat.

(Overgenomen van DependencyObject)
ReadPreamble()

Zorgt ervoor dat de Freezable thread wordt geopend vanuit een geldige thread. Overnames van Freezable deze methode moeten aan het begin van een API worden aangeroepen die gegevensleden leest die geen afhankelijkheidseigenschappen zijn.

(Overgenomen van Freezable)
SetCurrentValue(DependencyProperty, Object)

Hiermee stelt u de waarde van een afhankelijkheidseigenschap in zonder de waardebron te wijzigen.

(Overgenomen van DependencyObject)
SetValue(DependencyProperty, Object)

Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in, die is opgegeven door de id van de afhankelijkheidseigenschap.

(Overgenomen van DependencyObject)
SetValue(DependencyPropertyKey, Object)

Hiermee stelt u de lokale waarde van een alleen-lezen afhankelijkheidseigenschap in, die is opgegeven door de DependencyPropertyKey id van de afhankelijkheidseigenschap.

(Overgenomen van DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourneert een waarde die aangeeft of serialisatieprocessen de waarde voor de opgegeven afhankelijkheidseigenschap moeten serialiseren.

(Overgenomen van DependencyObject)
ToString()

Hiermee maakt u een tekenreeksweergave van dit object op basis van de huidige cultuur.

(Overgenomen van ImageSource)
ToString(IFormatProvider)

Hiermee maakt u een tekenreeksweergave van dit object op basis van de IFormatProvider doorgegeven tekenreeks. Als de provider is null, wordt de CurrentCulture provider gebruikt.

(Overgenomen van ImageSource)
VerifyAccess()

Hiermee wordt afgedwongen dat de aanroepende thread toegang heeft tot dit DispatcherObject.

(Overgenomen van DispatcherObject)
WritePostscript()

Hiermee wordt de gebeurtenis voor de Changed gebeurtenis gegenereerd en wordt Freezable de OnChanged() methode aangeroepen. Klassen die zijn afgeleid van Freezable , moeten deze methode aan het einde van een API aanroepen die klasseleden wijzigt die niet zijn opgeslagen als afhankelijkheidseigenschappen.

(Overgenomen van Freezable)
WritePreamble()

Controleert of het Freezable niet is geblokkeerd en of deze wordt geopend vanuit een geldige threadingcontext. Freezable overnemers moeten deze methode aan het begin van een API aanroepen die schrijft naar gegevensleden die geen afhankelijkheidseigenschappen zijn.

(Overgenomen van Freezable)

gebeurtenis

Name Description
Changed

Treedt op wanneer het Freezable object dat het bevat, wordt gewijzigd.

(Overgenomen van Freezable)
DecodeFailed

Treedt op wanneer de installatiekopieën niet kunnen worden geladen, vanwege een beschadigde afbeeldingskoptekst.

(Overgenomen van BitmapSource)
DownloadCompleted

Treedt op wanneer de bitmapinhoud volledig is gedownload.

(Overgenomen van BitmapSource)
DownloadFailed

Treedt op wanneer de bitmapinhoud niet kan worden gedownload.

(Overgenomen van BitmapSource)
DownloadProgress

Vindt plaats wanneer de downloadvoortgang van de bitmapinhoud is gewijzigd.

(Overgenomen van BitmapSource)

Expliciete interface-implementaties

Name Description
IFormattable.ToString(String, IFormatProvider)

Hiermee wordt de waarde van het huidige exemplaar opgemaakt met behulp van de opgegeven indeling.

(Overgenomen van ImageSource)

Van toepassing op

Zie ook