InPlaceBitmapMetadataWriter Třída

Definice

Obor názvů:

System.Windows.Media.Imaging

Sestavení:

PresentationCore.dll

Umožňuje místní aktualizace existujících bloků nástroje BitmapMetadata.

public ref class InPlaceBitmapMetadataWriter sealed : System::Windows::Media::Imaging::BitmapMetadata

public sealed class InPlaceBitmapMetadataWriter : System.Windows.Media.Imaging.BitmapMetadata

type InPlaceBitmapMetadataWriter = class
    inherit BitmapMetadata

Public NotInheritable Class InPlaceBitmapMetadataWriter
Inherits BitmapMetadata

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

ImageMetadata

BitmapMetadata

InPlaceBitmapMetadataWriter

Příklady

Tento příklad ukazuje, jak můžete upravit metadata v rámci obrázku bez nutnosti překódovat obrázek. Následující příklad používá k zápisu InPlaceBitmapMetadataWriter metadat do obrázku .

Stream^ pngStream = gcnew FileStream("smiley.png", FileMode::Open, FileAccess::ReadWrite, FileShare::ReadWrite);
PngBitmapDecoder^ pngDecoder = gcnew PngBitmapDecoder(pngStream, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapFrame^ pngFrame = pngDecoder->Frames[0];
InPlaceBitmapMetadataWriter^ pngInplace = pngFrame->CreateInPlaceBitmapMetadataWriter();
if (pngInplace->TrySave() == true)
{
   pngInplace->SetQuery("/Text/Description", "Have a nice day.");
}
pngStream->Close();

Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();

Dim pngStream As New System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite)
Dim pngDecoder As New PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim pngFrame As BitmapFrame = pngDecoder.Frames(0)
Dim pngInplace As InPlaceBitmapMetadataWriter = pngFrame.CreateInPlaceBitmapMetadataWriter()
If pngInplace.TrySave() = True Then
    pngInplace.SetQuery("/Text/Description", "Have a nice day.")
End If
pngStream.Close()

Poznámky

Pokud BitmapMetadata není přidružen k objektu BitmapFrame , který je získán prostřednictvím BitmapDecoder, pokus o zápis metadat pomocí místního zapisovače selže. Úspěšné operace zápisu aplikují metadata přímo na datový proud obrázků pomocí dekodéru.

Aktualizace místních metadat selžou, pokud dojde k pokusu o zápis metadat, která daný formát rastrového obrázku nepodporuje.

Chcete-li provádět úpravy metadat na místě, musí být rastrový obrázek dekódován pomocí Default možností mezipaměti nebo OnDemand . OnLoad nezaručuje přístup k datovému proudu metadat potřebným pro místní úpravy metadat.

Vlastnosti

ApplicationName	Získá nebo nastaví hodnotu, která identifikuje název aplikace, která byla použita k vytvoření nebo změně souboru bitové kopie. (Zděděno od BitmapMetadata)
Author	Získá nebo nastaví hodnotu, která představuje autora obrázku. (Zděděno od BitmapMetadata)
CameraManufacturer	Získá nebo nastaví hodnotu, která identifikuje výrobce fotoaparátu, který je přidružen k obrázku. (Zděděno od BitmapMetadata)
CameraModel	Získá nebo nastaví hodnotu, která identifikuje model kamery, který byl použit k zachycení obrazu. (Zděděno od BitmapMetadata)
CanFreeze	Získá hodnotu, která označuje, zda objekt lze změnit. (Zděděno od Freezable)
Comment	Získá nebo nastaví hodnotu, která představuje komentář, který je přidružen k souboru obrázku. (Zděděno od BitmapMetadata)
Copyright	Získá nebo nastaví hodnotu, která označuje informace o autorských právech, která je přidružena k souboru obrázku. (Zděděno od BitmapMetadata)
DateTaken	Získá nebo nastaví hodnotu, která označuje datum, kdy byl obrázek pořízen. (Zděděno od BitmapMetadata)
DependencyObjectType	Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá to DispatcherDispatcherObject je přidružena k. (Zděděno od DispatcherObject)
Format	Získá hodnotu, která identifikuje formát obrázku. (Zděděno od BitmapMetadata)
IsFixedSize	Získá hodnotu, která určuje, zda BitmapMetadata objekt má pevnou velikost. (Zděděno od BitmapMetadata)
IsFrozen	Získá hodnotu, která označuje, zda je objekt aktuálně upravitelný. (Zděděno od Freezable)
IsReadOnly	Získá hodnotu, která označuje, zda metadata, která je přidružena k obrázku je jen pro čtení. (Zděděno od BitmapMetadata)
IsSealed	Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Keywords	Získá nebo nastaví kolekci klíčových slov, které popisují rastrový obrázek. (Zděděno od BitmapMetadata)
Location	Získá hodnotu, která identifikuje základní umístění metadat, která je přidružena k obrázku. (Zděděno od BitmapMetadata)
Rating	Získá nebo nastaví hodnotu, která identifikuje hodnocení obrázku. (Zděděno od BitmapMetadata)
Subject	Získá nebo nastaví hodnotu, která označuje předmět rastrového obrázku. (Zděděno od BitmapMetadata)
Title	Získá nebo nastaví hodnotu, která identifikuje název souboru obrázku. (Zděděno od BitmapMetadata)

Metody

CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
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 InPlaceBitmapMetadataWriterobjektu 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 BitmapMetadataobjektu . (Zděděno od BitmapMetadata)
CloneCurrentValue()	Vytvoří upravitelný klon (hloubkovou kopii) objektu Freezable pomocí jeho aktuálních hodnot. (Zděděno od Freezable)
CloneCurrentValueCore(Freezable)	Vytvoří tuto instanci upravitelnou hloubkovou kopii zadané BitmapMetadata 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 BitmapMetadata)
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)
ContainsQuery(String)	Určuje, zda daný řetězec dotazu existuje v rámci objektu BitmapMetadata . (Zděděno od BitmapMetadata)
CreateInstance()	Inicializuje novou instanci Freezable třídy . (Zděděno od Freezable)
CreateInstanceCore()	Implementace .CreateInstance() (Zděděno od BitmapMetadata)
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 true. (Zděděno od Freezable)
FreezeCore(Boolean)	Nastaví objekt jako Freezable neupravitelný nebo testuje, jestli ho nelze změnit. (Zděděno od Freezable)
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 BitmapMetadata objektu. (Zděděno od BitmapMetadata)
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 BitmapMetadataobjektu . Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty ano. (Zděděno od BitmapMetadata)
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)
GetQuery(String)	Poskytuje přístup ke čtečce dotazů na metadata, která může extrahovat metadata ze souboru rastrového obrázku. (Zděděno od BitmapMetadata)
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)
RemoveQuery(String)	Odebere dotaz na metadata z instance objektu BitmapMetadata. (Zděděno od BitmapMetadata)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetQuery(String, Object)	Poskytuje přístup k zapisovači dotazů na metadata, který může zapisovat metadata do souboru rastrového obrázku. (Zděděno od BitmapMetadata)
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()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrySave()	Získá hodnotu, která označuje, zda lze úspěšně uložit metadata obrázku.
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)

Explicitní implementace rozhraní

IEnumerable.GetEnumerator()	Popis tohoto člena najdete v tématu GetEnumerator(). (Zděděno od BitmapMetadata)
IEnumerable<String>.GetEnumerator()	Popis tohoto člena najdete v tématu GetEnumerator(). (Zděděno od BitmapMetadata)

Metody rozšíření

Viz také

• BitmapMetadata
• BitmapImage