BitmapImage Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Speciális BitmapSource , képek betöltésére optimalizált, XAML(Extensible Application Markup Language, Extensible Application Markup Language) nyelv használatával.
public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContextpublic sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContexttype BitmapImage = class
inherit BitmapSource
interface ISupportInitialize
interface IUriContextPublic NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext- Öröklődés
- Megvalósítás
Példák
Az alábbi példakódok bemutatják, hogyan használható egy BitmapImage bővíthető alkalmazásjelölési nyelv (XAML) és kód.
<!-- 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
Megjegyzések
BitmapImage elsősorban az Extensible Application Markup Language (XAML) szintaxisának támogatására létezik, és további tulajdonságokat vezet be a bitképek betöltéséhez, amelyeket nem határoz meg a BitmapSourceprogram.
BitmapImage implementálja a felületet, ISupportInitialize hogy optimalizálja az inicializálást több tulajdonságon. A tulajdonságmódosítások csak az objektum inicializálása során fordulhatnak elő. Az BeginInit inicializálás megkezdésének jelzésére és EndInit az inicializálás befejezésének jelzésére. Az inicializálás után a rendszer figyelmen kívül hagyja a tulajdonság módosításait.
BitmapImage A BitmapImage konstruktor használatával létrehozott objektumok automatikusan inicializálódnak, és a tulajdonságmódosítások figyelmen kívül lesznek hagyva.
Konstruktorok
| Name | Description |
|---|---|
| BitmapImage() |
Inicializálja a BitmapImage osztály új példányát. |
| BitmapImage(Uri, RequestCachePolicy) |
Inicializálja az BitmapImage osztály új példányát egy olyan képpel, amelynek a forrása egy Uri, és a megadottnak RequestCachePolicymegfelelően gyorsítótárazza. |
| BitmapImage(Uri) |
Inicializálja az osztály új példányát a BitmapImage megadott Uri. |
Mezők
| Name | Description |
|---|---|
| CacheOptionProperty |
Azonosítja a CacheOption függőségi tulajdonságot. |
| CreateOptionsProperty |
Azonosítja a CreateOptions függőségi tulajdonságot. |
| DecodePixelHeightProperty |
Azonosítja a DecodePixelHeight függőségi tulajdonságot. |
| DecodePixelWidthProperty |
Azonosítja a DecodePixelWidth függőségi tulajdonságot. |
| RotationProperty |
Azonosítja a Rotation függőségi tulajdonságot. |
| SourceRectProperty |
Azonosítja a SourceRect függőségi tulajdonságot. |
| StreamSourceProperty |
Azonosítja a StreamSource függőségi tulajdonságot. |
| UriCachePolicyProperty |
Azonosítja a UriCachePolicy függőségi tulajdonságot. |
| UriSourceProperty |
Azonosítja a UriSource függőségi tulajdonságot. |
Tulajdonságok
| Name | Description |
|---|---|
| BaseUri |
Lekéri vagy beállítja az aktuális Uri környezet alapját BitmapImage képviselő értéket. |
| CacheOption |
Lekéri vagy beállítja az BitmapCacheOption adott példányhoz használni kívánt példányt BitmapImage. |
| CanFreeze |
Olyan értéket kap, amely jelzi, hogy az objektum módosítható-e. (Öröklődés forrása Freezable) |
| CreateOptions |
Lekéri vagy beállítja a BitmapCreateOptions .BitmapImage |
| DecodePixelHeight |
Képpontban lekéri vagy beállítja azt a magasságot, amelybe a kép dekódolva van. |
| DecodePixelWidth |
Képpontban lekéri vagy beállítja azt a szélességet, amelybe a rendszer a képet dekódolja. |
| DependencyObjectType |
Lekéri a DependencyObjectType példány CLR-típusát körbefuttatót. (Öröklődés forrása DependencyObject) |
| Dispatcher |
Lekérdezi, Dispatcher hogy ez a társítva van-e DispatcherObject . (Öröklődés forrása DispatcherObject) |
| DpiX |
Lekéri a kép vízszintes pont/hüvelyk (dpi) pontját. (Öröklődés forrása BitmapSource) |
| DpiY |
Lekéri a kép függőleges pont/hüvelyk (dpi) pontját. (Öröklődés forrása BitmapSource) |
| Format |
Lekéri a bitképadatok natív PixelFormat adatait. (Öröklődés forrása BitmapSource) |
| HasAnimatedProperties |
Olyan értéket kap, amely jelzi, hogy egy vagy több AnimationClock objektum társítva van-e az objektum függőségi tulajdonságainak bármelyikéhez. (Öröklődés forrása Animatable) |
| Height |
Lekéri a forrásbitkép magasságát az eszközfüggetlen egységekben (egységenként 1/96 hüvelyk). (Öröklődés forrása BitmapSource) |
| IsDownloading |
Egy olyan értéket kap, amely jelzi, hogy az éppen letölti-e a BitmapImage tartalmat. |
| IsFrozen |
Olyan értéket kap, amely jelzi, hogy az objektum jelenleg módosítható-e. (Öröklődés forrása Freezable) |
| IsSealed |
Olyan értéket kap, amely jelzi, hogy a példány jelenleg zárolva van-e (írásvédett). (Öröklődés forrása DependencyObject) |
| Metadata |
Nem támogatott. BitmapImage nem támogatja a Metadata tulajdonságot, és egy NotSupportedException. |
| Palette |
Lekéri a bitkép színpalettáját, ha van megadva. (Öröklődés forrása BitmapSource) |
| PixelHeight |
Képpontban adja meg a bitkép magasságát. (Öröklődés forrása BitmapSource) |
| PixelWidth |
A bitkép szélességét képpontban adja meg. (Öröklődés forrása BitmapSource) |
| Rotation |
Lekéri vagy beállítja a BitmapImage forgatási szöget. |
| SourceRect |
Lekéri vagy beállítja a forrásként használt téglalapot BitmapImage. |
| StreamSource |
Lekéri vagy beállítja a stream forrását.BitmapImage |
| UriCachePolicy |
Lekéri vagy beállítja a HTTP-forrásból származó képek gyorsítótárazási házirendjének megfelelő értéket. |
| UriSource |
Lekéri vagy beállítja a Uri forrást.BitmapImage |
| Width |
Lekéri a bitkép szélességét az eszközfüggetlen egységekben (egységenként 1/96 hüvelyk). (Öröklődés forrása BitmapSource) |
Metódusok
| Name | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Alkalmazza AnimationClock a megadott DependencyProperty. Ha a tulajdonság már animálva van, a rendszer a megadott HandoffBehavior értéket használja. (Öröklődés forrása Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Alkalmazza AnimationClock a megadott DependencyProperty. Ha a tulajdonság már animálva van, a rendszer az SnapshotAndReplace átadási viselkedést használja. (Öröklődés forrása Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Animációt alkalmaz a megadottra DependencyProperty. Az animáció a következő képkocka megjelenítésekor indul el. Ha a megadott tulajdonság már animálva van, a rendszer a megadott HandoffBehavior tulajdonságot használja. (Öröklődés forrása Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Animációt alkalmaz a megadottra DependencyProperty. Az animáció a következő képkocka megjelenítésekor indul el. Ha a megadott tulajdonság már animálva van, a rendszer az SnapshotAndReplace átadási viselkedést használja. (Öröklődés forrása Animatable) |
| BeginInit() |
Az inicializálás kezdetét BitmapImage jelzi. |
| CheckAccess() |
Meghatározza, hogy a hívó szál hozzáfér-e ehhez DispatcherObject. (Öröklődés forrása DispatcherObject) |
| CheckIfSiteOfOrigin() |
Ellenőrzi, hogy a bitkép forrástartalma ismert forráshelyről származik-e. Ezzel a módszerrel biztosítható, hogy a képpontmásolási műveletek biztonságosak legyenek. (Öröklődés forrása BitmapSource) |
| ClearValue(DependencyProperty) |
Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg. (Öröklődés forrása DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyPropertyKey. (Öröklődés forrása DependencyObject) |
| Clone() |
Ennek egy módosítható klónját BitmapImagehozza létre, amely az objektum értékeinek részletes másolatát készíti el. |
| CloneCore(Freezable) |
Ez a példány a megadott példány mély másolatává válik BitmapSource. A függőségi tulajdonságok másolásakor ez a módszer az erőforrás-hivatkozásokat és az adatkötéseket másolja (de előfordulhat, hogy ezek már nem oldódnak fel), de nem animációkat vagy az aktuális értékeket. (Öröklődés forrása BitmapSource) |
| CloneCurrentValue() |
Módosítható klónt hoz létre az BitmapImage objektumról, amely részletes másolatokat készít az objektum aktuális értékeiről. Az erőforráshivatkozások, az adatkötések és az animációk nem másolódnak, de az aktuális értékük igen. |
| CloneCurrentValueCore(Freezable) |
Ez a példány módosítható mély másolattá teszi a megadottat BitmapSource az aktuális tulajdonságértékek használatával. Az erőforráshivatkozások, az adatkötések és az animációk nem másolódnak, de az aktuális értékük igen. (Öröklődés forrása BitmapSource) |
| CoerceValue(DependencyProperty) |
A megadott függőségi tulajdonság értékét kényszeríti. Ez úgy érhető el, hogy meghívja a függőségi tulajdonság tulajdonság metaadataiban megadott függvényeket CoerceValueCallback a hívás DependencyObjectsorán. (Öröklődés forrása DependencyObject) |
| CopyPixels(Array, Int32, Int32) |
A bitkép képpontadatait a megadott léptekkel rendelkező képponttömbbe másolja, a megadott eltolástól kezdve. (Öröklődés forrása BitmapSource) |
| CopyPixels(Int32Rect, Array, Int32, Int32) |
Másolja a bitkép képpontadatait a megadott téglalapon belül egy képponttömbbe, amely a megadott lépéssel rendelkezik a megadott eltolástól kezdve. (Öröklődés forrása BitmapSource) |
| CopyPixels(Int32Rect, IntPtr, Int32, Int32) |
Másolja a bitkép képpontadatait a megadott téglalapba. (Öröklődés forrása BitmapSource) |
| CreateInstance() |
Inicializálja a Freezable osztály új példányát. (Öröklődés forrása Freezable) |
| CreateInstanceCore() |
Ha egy származtatott osztályban implementálják, a származtatott osztály új példányát Freezable hozza létre. (Öröklődés forrása Freezable) |
| EndInit() |
Az inicializálás végét BitmapImage jelzi. |
| Equals(Object) |
Meghatározza, hogy a megadott DependencyObject érték megegyezik-e az aktuális DependencyObjectértékével. (Öröklődés forrása DependencyObject) |
| Freeze() |
Az aktuális objektum nem módosítható, és a tulajdonságát a következőre IsFrozenállítja |
| FreezeCore(Boolean) |
Egy példány BitmapSource vagy származtatott osztály nem módosíthatóvá válik. (Öröklődés forrása BitmapSource) |
| GetAnimationBaseValue(DependencyProperty) |
A megadott DependencyPropertyérték nem animált értékét adja vissza. (Öröklődés forrása Animatable) |
| GetAsFrozen() |
Az alaptulajdonságok Freezable(nem animált) értékeinek egy fagyasztott másolatát hozza létre. Mivel a másolat le van fagyasztva, a program hivatkozással másolja a befagyott alobjektumokat. (Öröklődés forrása Freezable) |
| GetAsFrozenCore(Freezable) |
Ez a példány a megadott BitmapSource objektum klónja lesz. (Öröklődés forrása BitmapSource) |
| GetCurrentValueAsFrozen() |
Az aktuális tulajdonságértékek fagyasztott másolatát Freezable hozza létre. Mivel a másolat le van fagyasztva, a program hivatkozással másolja a befagyott alobjektumokat. (Öröklődés forrása Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Ez a példány a megadott BitmapSourceklón fagyasztott klónja lesz. Az erőforráshivatkozások, az adatkötések és az animációk nem másolódnak, de az aktuális értékük igen. (Öröklődés forrása BitmapSource) |
| GetHashCode() |
Ehhez lekéri a DependencyObjectkivonatkódot. (Öröklődés forrása DependencyObject) |
| GetLocalValueEnumerator() |
Létrehoz egy speciális enumerátort annak meghatározásához, hogy mely függőségi tulajdonságok rendelkeznek helyileg beállított értékekkel.DependencyObject (Öröklődés forrása DependencyObject) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| GetValue(DependencyProperty) |
Egy függőségi tulajdonság aktuális tényleges értékét adja vissza az adott példányon DependencyObject. (Öröklődés forrása DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Újra kiértékeli a megadott függőségi tulajdonság tényleges értékét. (Öröklődés forrása DependencyObject) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| OnChanged() |
Az aktuális Freezable objektum módosításakor hívható meg. (Öröklődés forrása Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál. (Öröklődés forrása Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Biztosítja, hogy a megfelelő környezeti mutatók létre legyenek hozva az DependencyObjectType éppen beállított adattagok számára. (Öröklődés forrása Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Felülbírálja a DependencyObject változó típusú függőségi tulajdonságra válaszul a kezelők meghívásának OnPropertyChanged(DependencyPropertyChangedEventArgs)Changedvégrehajtását Freezable is. (Öröklődés forrása Freezable) |
| ReadLocalValue(DependencyProperty) |
Egy függőségi tulajdonság helyi értékét adja vissza, ha létezik. (Öröklődés forrása DependencyObject) |
| ReadPreamble() |
Biztosítja, hogy a Freezable rendszer érvényes szálról legyen elérhető. A metódus öröklőinek Freezable minden olyan API elején meg kell hívniuk ezt a metódust, amely olyan adattagokat olvas be, amelyek nem függőségi tulajdonságok. (Öröklődés forrása Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Beállítja egy függőségi tulajdonság értékét az értékforrás módosítása nélkül. (Öröklődés forrása DependencyObject) |
| SetValue(DependencyProperty, Object) |
Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Olyan értéket ad vissza, amely jelzi, hogy a szerializálási folyamatok szerializálják-e a megadott függőségi tulajdonság értékét. (Öröklődés forrása DependencyObject) |
| ToString() |
Az objektum sztring-ábrázolását hozza létre az aktuális kultúra alapján. (Öröklődés forrása ImageSource) |
| ToString(IFormatProvider) |
Sztringképet hoz létre az objektumról az IFormatProvider átadott fájl alapján. Ha a szolgáltató az |
| VerifyAccess() |
Kényszeríti, hogy a hívószál hozzáférhessen ehhez.DispatcherObject (Öröklődés forrása DispatcherObject) |
| WritePostscript() |
Elindítja az Changed eseményt, Freezable és meghívja annak metódusát OnChanged() . A származtatott Freezable osztályoknak ezt a metódust minden olyan API végén kell meghívni, amely módosítja a nem függőségi tulajdonságokként tárolt osztálytagokat. (Öröklődés forrása Freezable) |
| WritePreamble() |
Ellenőrzi, hogy a Freezable rendszer nem zárolta-e a elemet, és hogy az érvényes szálkezelési környezetből van-e elérhető. Freezable Az öröklőknek ezt a metódust minden olyan API elején kell meghívni, amely nem függőségi tulajdonságokat tartalmazó adattagoknak ír. (Öröklődés forrása Freezable) |
esemény
| Name | Description |
|---|---|
| Changed |
Akkor fordul elő, ha a Freezable benne lévő objektum vagy objektum módosul. (Öröklődés forrása Freezable) |
| DecodeFailed |
Akkor fordul elő, ha a rendszerkép nem töltődik be egy sérült képfejléc miatt. (Öröklődés forrása BitmapSource) |
| DownloadCompleted |
Akkor fordul elő, ha a bitkép tartalma teljesen le lett töltve. (Öröklődés forrása BitmapSource) |
| DownloadFailed |
Akkor fordul elő, ha a bitkép tartalma nem tölthető le. (Öröklődés forrása BitmapSource) |
| DownloadProgress |
Akkor fordul elő, ha a bitkép tartalmának letöltési állapota megváltozott. (Öröklődés forrása BitmapSource) |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Formázza az aktuális példány értékét a megadott formátummal. (Öröklődés forrása ImageSource) |
