ColorConvertedBitmap Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Změní barevný prostor v .BitmapSource
public ref class ColorConvertedBitmap sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize
public sealed class ColorConvertedBitmap : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize
type ColorConvertedBitmap = class
inherit BitmapSource
interface ISupportInitialize
Public NotInheritable Class ColorConvertedBitmap
Inherits BitmapSource
Implements ISupportInitialize
- Dědičnost
-
ColorConvertedBitmap
- Implementuje
Příklady
Následující příklad ukazuje, jak vytvořit instanci objektu ColorConvertedBitmap a použít ji k převodu barvy.
Stream imageStream = new FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read);
BitmapSource myBitmapSource = BitmapFrame.Create(imageStream);
BitmapFrame myBitmapSourceFrame = (BitmapFrame)myBitmapSource;
ColorContext sourceColorContext = myBitmapSourceFrame.ColorContexts[0];
ColorContext destColorContext = new ColorContext(PixelFormats.Bgra32);
ColorConvertedBitmap ccb = new ColorConvertedBitmap(myBitmapSource, sourceColorContext, destColorContext, PixelFormats.Pbgra32);
Image myImage3 = new Image();
myImage3.Source = ccb;
myImage3.Stretch = Stretch.None;
imageStream.Close();
Dim imageStream As New FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim myBitmapSource As BitmapSource = BitmapFrame.Create(imageStream)
Dim myBitmapSourceFrame As BitmapFrame = CType(myBitmapSource, BitmapFrame)
Dim sourceColorContext As ColorContext = myBitmapSourceFrame.ColorContexts(0)
Dim destColorContext As New ColorContext(PixelFormats.Bgra32)
Dim ccb As New ColorConvertedBitmap(myBitmapSource, sourceColorContext, destColorContext, PixelFormats.Pbgra32)
Dim myImage3 As New Image()
myImage3.Source = ccb
myImage3.Stretch = Stretch.None
imageStream.Close()
Poznámky
Informace o použití XAML najdete v tématu ColorConvertedBitmap – rozšíření značek.
ColorConvertedBitmap implementuje ISupportInitialize rozhraní pro optimalizaci inicializace více vlastností. Ke změnám vlastností může dojít pouze během inicializace objektu. Volání BeginInit signálu, že inicializace byla zahájena, a EndInit signalizovat, že inicializace byla dokončena. Po inicializaci jsou změny vlastností ignorovány.
ColorConvertedBitmap objekty vytvořené pomocí konstruktoru ColorConvertedBitmap(BitmapSource, ColorContext, ColorContext, PixelFormat) jsou automaticky inicializovány a změny vlastností jsou ignorovány.
A ColorConvertedBitmap se nikdy neumisí do mezipaměti.
Konstruktory
ColorConvertedBitmap() |
Inicializuje novou instanci ColorConvertedBitmap třídy . |
ColorConvertedBitmap(BitmapSource, ColorContext, ColorContext, PixelFormat) |
Inicializuje novou instanci ColorConvertedBitmap třídy pomocí zadaných hodnot. |
Pole
DestinationColorContextProperty |
Identifikuje DestinationColorContext vlastnost závislosti. |
DestinationFormatProperty |
Identifikuje DestinationFormat vlastnost závislosti. |
SourceColorContextProperty |
Identifikuje SourceColorContext vlastnost závislosti. |
SourceProperty |
Identifikuje Source vlastnost závislosti. |
Vlastnosti
CanFreeze |
Získá hodnotu, která označuje, zda objekt lze změnit. (Zděděno od Freezable) |
DependencyObjectType |
Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject) |
DestinationColorContext |
Získá nebo nastaví hodnotu, která identifikuje barevný profil, jak je definováno ColorContext třídou, převedeného rastrového obrázku. |
DestinationFormat |
Získá nebo nastaví hodnotu, která představuje PixelFormat převedený rastrový obrázek. |
Dispatcher |
Získá to DispatcherDispatcherObject je přidružena k. (Zděděno od DispatcherObject) |
DpiX |
Získá vodorovné tečky na palec (dpi) obrázku. (Zděděno od BitmapSource) |
DpiY |
Získá svislé tečky na palec (dpi) obrázku. (Zděděno od BitmapSource) |
Format |
Získá nativní PixelFormat rastrová data. (Zděděno od BitmapSource) |
HasAnimatedProperties |
Získá hodnotu, která označuje, zda jeden nebo více AnimationClock objektů je přidružena k některému z vlastností závislostí tohoto objektu. (Zděděno od Animatable) |
Height |
Získá výšku zdrojového rastrového obrázku v jednotkách nezávislých na zařízení (1/96 palce na jednotku). (Zděděno od BitmapSource) |
IsDownloading |
Získá hodnotu, která označuje, zda BitmapSource se obsah právě stahuje. (Zděděno od BitmapSource) |
IsFrozen |
Získá hodnotu, která označuje, zda je objekt aktuálně upravitelný. (Zděděno od Freezable) |
IsSealed |
Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject) |
Metadata |
Získá metadata, která je přidružena k tomuto rastrovém obrázku. (Zděděno od BitmapSource) |
Palette |
Získá paletu barev bitmapy, pokud je zadán. (Zděděno od BitmapSource) |
PixelHeight |
Získá výšku bitmapy v pixelech. (Zděděno od BitmapSource) |
PixelWidth |
Získá šířku rastru v pixelech. (Zděděno od BitmapSource) |
Source |
Získá nebo nastaví hodnotu, která identifikuje zdrojový rastrový obrázek, který je převeden. |
SourceColorContext |
Získá nebo nastaví hodnotu, která identifikuje barevný profil zdrojové bitmapy. |
Width |
Získá šířku rastru v jednotkách nezávislých na zařízení (1/96 palce na jednotku). (Zděděno od BitmapSource) |
Metody
ApplyAnimationClock(DependencyProperty, AnimationClock) |
Použije na AnimationClock zadanou DependencyPropertyhodnotu . Pokud je vlastnost už animovaná, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable) |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Použije na AnimationClock zadanou DependencyPropertyhodnotu . Pokud je vlastnost už animovaná, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline) |
Použije animaci na zadaný objekt DependencyProperty. Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Použije animaci na zadaný objekt DependencyProperty. Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animovaná, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable) |
BeginInit() |
Signalizuje začátek ColorConvertedBitmap inicializace. |
CheckAccess() |
Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
CheckIfSiteOfOrigin() |
Zkontroluje, zda zdrojový obsah rastrového obrázku pochází ze známého webu původu. Tato metoda se používá k zajištění, že operace kopírování pixelů jsou bezpečné. (Zděděno od BitmapSource) |
ClearValue(DependencyProperty) |
Vymaže místní hodnotu vlastnosti. Vlastnost, která má být vymazána, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject) |
ClearValue(DependencyPropertyKey) |
Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject) |
Clone() |
Vytvoří upravitelný klon tohoto ColorConvertedBitmapobjektu a vytvoří hluboké kopie hodnot tohoto objektu. Při kopírování vlastností závislostí tato metoda kopíruje odkazy na prostředky a datové vazby (ale nemusí se už překládat), ale ne animace nebo jejich aktuální hodnoty. |
CloneCore(Freezable) |
Vytvoří tuto instanci jako hlubokou kopii zadaného BitmapSourceobjektu . Při kopírování vlastností závislostí tato metoda kopíruje odkazy na prostředky a datové vazby (ale nemusí se už překládat), ale ne animace nebo jejich aktuální hodnoty. (Zděděno od BitmapSource) |
CloneCurrentValue() |
Vytvoří upravitelný klon tohoto ColorConvertedBitmap objektu a vytvoří hluboké kopie aktuálních hodnot tohoto objektu. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty ano. |
CloneCurrentValueCore(Freezable) |
Vytvoří tuto instanci upravitelnou hloubkovou kopii zadané BitmapSource pomocí aktuálních hodnot vlastností. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty ano. (Zděděno od BitmapSource) |
CoerceValue(DependencyProperty) |
Převede hodnotu zadané vlastnosti závislosti. Toho se dosáhne vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject) |
CopyPixels(Array, Int32, Int32) |
Zkopíruje data rastrových pixelů do pole pixelů se zadaným krokem počínaje zadaným posunem. (Zděděno od BitmapSource) |
CopyPixels(Int32Rect, Array, Int32, Int32) |
Zkopíruje data rastrových pixelů v zadaném obdélníku do pole pixelů, které má zadaný krok začínající na zadaném posunu. (Zděděno od BitmapSource) |
CopyPixels(Int32Rect, IntPtr, Int32, Int32) |
Zkopíruje data rastrových pixelů v zadaném obdélníku. (Zděděno od BitmapSource) |
CreateInstance() |
Inicializuje novou instanci Freezable třídy . (Zděděno od Freezable) |
CreateInstanceCore() |
Při implementaci v odvozené třídě vytvoří novou instanci odvozené Freezable třídy. (Zděděno od Freezable) |
EndInit() |
Signalizuje konec ColorConvertedBitmap inicializace. |
Equals(Object) |
Určuje, zda zadaný DependencyObject je ekvivalentní k aktuálnímu DependencyObject. (Zděděno od DependencyObject) |
Freeze() |
Nastaví aktuální objekt jako neupravitelný a nastaví jeho IsFrozen vlastnost na |
FreezeCore(Boolean) |
Nastaví instanci BitmapSource nebo odvozenou třídu neměnnou. (Zděděno od BitmapSource) |
GetAnimationBaseValue(DependencyProperty) |
Vrátí ne animovanou hodnotu zadané DependencyPropertyhodnoty . (Zděděno od Animatable) |
GetAsFrozen() |
Vytvoří zamrzlou kopii objektu Freezables použitím základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, jsou všechny ukotvené dílčí objekty zkopírovány odkazem. (Zděděno od Freezable) |
GetAsFrozenCore(Freezable) |
Vytvoří tuto instanci klon zadaného BitmapSource objektu. (Zděděno od BitmapSource) |
GetCurrentValueAsFrozen() |
Vytvoří zamrzlou kopii objektu Freezable s použitím aktuálních hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, jsou všechny ukotvené dílčí objekty zkopírovány odkazem. (Zděděno od Freezable) |
GetCurrentValueAsFrozenCore(Freezable) |
Vytvoří tuto instanci zablokovaný klon zadaného BitmapSourceobjektu . Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty ano. (Zděděno od BitmapSource) |
GetHashCode() |
Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject) |
GetLocalValueEnumerator() |
Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
GetValue(DependencyProperty) |
Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject) |
InvalidateProperty(DependencyProperty) |
Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
OnChanged() |
Volána při změně aktuálního Freezable objektu. (Zděděno od Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Zajišťuje, že jsou vytvořeny vhodné ukazatele kontextu pro DependencyObjectType datový člen, který byl právě nastaven. (Zděděno od Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Tento člen podporuje infrastrukturu Windows Presentation Foundation (WPF) a není určen k použití přímo z vašeho kódu. (Zděděno od Freezable) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Přepíše implementaci DependencyObject tak, OnPropertyChanged(DependencyPropertyChangedEventArgs) aby také vyvolala všechny Changed obslužné rutiny v reakci na měnící se vlastnost závislosti typu Freezable. (Zděděno od Freezable) |
ReadLocalValue(DependencyProperty) |
Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject) |
ReadPreamble() |
Zajišťuje, že Freezable se k souboru přistupuje z platného vlákna. Dědíci Freezable musí tuto metodu volat na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnosti závislostí. (Zděděno od Freezable) |
SetCurrentValue(DependencyProperty, Object) |
Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject) |
SetValue(DependencyProperty, Object) |
Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject) |
SetValue(DependencyPropertyKey, Object) |
Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject) |
ToString() |
Vytvoří řetězcovou reprezentaci tohoto objektu na základě aktuální jazykové verze. (Zděděno od ImageSource) |
ToString(IFormatProvider) |
Vytvoří řetězcovou reprezentaci tohoto objektu IFormatProvider na základě předaného. Pokud je |
VerifyAccess() |
Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
WritePostscript() |
Changed Vyvolá událost pro Freezable a vyvolá jeho OnChanged() metodu. Třídy odvozené z Freezable by měly tuto metodu volat na konci jakéhokoli rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislosti. (Zděděno od Freezable) |
WritePreamble() |
Ověřuje, že Freezable objekt není zamrznutý a že se k němu přistupuje z platného kontextu podprocesů. Freezable Dědiče by tuto metodu měli volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnosti závislostí. (Zděděno od Freezable) |
Událost
Changed |
Vyvolá se při změně objektu Freezable nebo objektu, který obsahuje. (Zděděno od Freezable) |
DecodeFailed |
Vyvolá se, když se kvůli poškozené hlavičce image nepodaří načíst image. (Zděděno od BitmapSource) |
DownloadCompleted |
Vyvolá se v případě, že byl obsah rastrového obrázku zcela stažen. (Zděděno od BitmapSource) |
DownloadFailed |
Vyvolá se, když se obsah rastrového obrázku nepodařilo stáhnout. (Zděděno od BitmapSource) |
DownloadProgress |
Vyvolá se při průběhu stahování obsahu rastrového obrázku změněna. (Zděděno od BitmapSource) |
Explicitní implementace rozhraní
IFormattable.ToString(String, IFormatProvider) |
Formátuje hodnotu aktuální instance pomocí zadaného formátu. (Zděděno od ImageSource) |