InPlaceBitmapMetadataWriter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
BitmapMetadataの既存のブロックに対するインプレース更新を有効にします。
public ref class InPlaceBitmapMetadataWriter sealed : System::Windows::Media::Imaging::BitmapMetadatapublic sealed class InPlaceBitmapMetadataWriter : System.Windows.Media.Imaging.BitmapMetadatatype InPlaceBitmapMetadataWriter = class
inherit BitmapMetadataPublic NotInheritable Class InPlaceBitmapMetadataWriter
Inherits BitmapMetadata- 継承
-
InPlaceBitmapMetadataWriter
例
この例では、イメージを再エンコードすることなく、イメージ内のメタデータを変更する方法を示します。 次の例では、 InPlaceBitmapMetadataWriter を使用してメタデータをイメージに書き込みます。
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())
{
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())
{ 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()
注釈
BitmapMetadataがBitmapFrameによって取得されたBitmapDecoderに関連付けられていない場合、インプレース ライターを使用してメタデータを書き込もうとすると失敗します。 書き込み操作が成功すると、デコーダーを使用してメタデータがイメージ ストリームに直接適用されます。
インプレース メタデータの更新は、特定のビットマップ形式でサポートされていないメタデータを書き込もうとすると失敗します。
インプレース メタデータ編集を実行するには、 Default または OnDemand キャッシュ オプションを使用してビットマップをデコードする必要があります。 OnLoad では、インプレース メタデータ編集に必要なメタデータ ストリームへのアクセスは保証されません。
プロパティ
| 名前 | 説明 |
|---|---|
| ApplicationName |
イメージ ファイルの構築または変更に使用されたアプリケーションの名前を識別する値を取得または設定します。 (継承元 BitmapMetadata) |
| Author |
イメージの作成者を表す値を取得または設定します。 (継承元 BitmapMetadata) |
| CameraManufacturer |
イメージに関連付けられているカメラの製造元を識別する値を取得または設定します。 (継承元 BitmapMetadata) |
| CameraModel |
イメージのキャプチャに使用されたカメラ モデルを識別する値を取得または設定します。 (継承元 BitmapMetadata) |
| CanFreeze |
オブジェクトを変更不可にできるかどうかを示す値を取得します。 (継承元 Freezable) |
| Comment |
イメージ ファイルに関連付けられているコメントを表す値を取得または設定します。 (継承元 BitmapMetadata) |
| Copyright |
イメージ ファイルに関連付けられている著作権情報を示す値を取得または設定します。 (継承元 BitmapMetadata) |
| DateTaken |
イメージが取得された日付を示す値を取得または設定します。 (継承元 BitmapMetadata) |
| DependencyObjectType |
このインスタンスの CLR 型をラップする DependencyObjectType を取得します。 (継承元 DependencyObject) |
| Dispatcher |
このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject) |
| Format |
イメージの形式を識別する値を取得します。 (継承元 BitmapMetadata) |
| IsFixedSize |
BitmapMetadata オブジェクトが固定サイズかどうかを決定する値を取得します。 (継承元 BitmapMetadata) |
| IsFrozen |
オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable) |
| IsReadOnly |
イメージに関連付けられているメタデータが読み取り専用かどうかを示す値を取得します。 (継承元 BitmapMetadata) |
| IsSealed |
このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject) |
| Keywords |
ビットマップ イメージを記述するキーワードのコレクションを取得または設定します。 (継承元 BitmapMetadata) |
| Location |
イメージに関連付けられているメタデータの基本位置を識別する値を取得します。 (継承元 BitmapMetadata) |
| Rating |
イメージの評価を識別する値を取得または設定します。 (継承元 BitmapMetadata) |
| Subject |
ビットマップ イメージの主題を示す値を取得または設定します。 (継承元 BitmapMetadata) |
| Title |
イメージ ファイルのタイトルを識別する値を取得または設定します。 (継承元 BitmapMetadata) |
メソッド
| 名前 | 説明 |
|---|---|
| CheckAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject) |
| ClearValue(DependencyProperty) |
プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyProperty 識別子によって指定されます。 (継承元 DependencyObject) |
| ClearValue(DependencyPropertyKey) |
読み取り専用プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyPropertyKeyによって指定されます。 (継承元 DependencyObject) |
| Clone() |
この InPlaceBitmapMetadataWriterの変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 依存関係プロパティをコピーする場合、このメソッドはリソース参照とデータ バインディングをコピーします (ただし、解決されなくなる可能性があります)、アニメーションやその現在の値はコピーしません。 |
| CloneCore(Freezable) |
このインスタンスを、指定した BitmapMetadataのディープ コピーにします。 (継承元 BitmapMetadata) |
| CloneCurrentValue() |
現在の値を使用して、 Freezable の変更可能な複製 (ディープ コピー) を作成します。 (継承元 Freezable) |
| CloneCurrentValueCore(Freezable) |
現在のプロパティ値を使用して、このインスタンスを指定した BitmapMetadata の変更可能なディープ コピーにします。 リソース参照、データ バインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 (継承元 BitmapMetadata) |
| CoerceValue(DependencyProperty) |
指定した依存関係プロパティの値を強制します。 これは、呼び出し元のCoerceValueCallbackに存在する依存関係プロパティのプロパティ メタデータで指定されたDependencyObject関数を呼び出すことによって実現されます。 (継承元 DependencyObject) |
| ContainsQuery(String) |
特定のクエリ文字列が BitmapMetadata オブジェクト内に存在するかどうかを判断します。 (継承元 BitmapMetadata) |
| CreateInstance() |
Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable) |
| CreateInstanceCore() |
CreateInstance()の実装。 (継承元 BitmapMetadata) |
| Equals(Object) |
指定された DependencyObject が現在の DependencyObjectと等しいかどうかを判断します。 (継承元 DependencyObject) |
| Freeze() |
現在のオブジェクトを変更不可にし、その IsFrozen プロパティを |
| FreezeCore(Boolean) |
Freezable オブジェクトを変更不可にするか、変更不可にできるかどうかをテストします。 (継承元 Freezable) |
| GetAsFrozen() |
基本 (アニメーション化されていない) プロパティ値を使用して、 Freezableの固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetAsFrozenCore(Freezable) |
このインスタンスを、指定した BitmapMetadata オブジェクトの複製にします。 (継承元 BitmapMetadata) |
| GetCurrentValueAsFrozen() |
現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
このインスタンスを、指定した BitmapMetadataの固定された複製にします。 リソース参照、データ バインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 (継承元 BitmapMetadata) |
| GetHashCode() |
この DependencyObjectのハッシュ コードを取得します。 (継承元 DependencyObject) |
| GetLocalValueEnumerator() |
この DependencyObjectでローカルに値が設定されている依存関係プロパティを決定するための特殊な列挙子を作成します。 (継承元 DependencyObject) |
| GetQuery(String) |
ビットマップ イメージ ファイルからメタデータを抽出できるメタデータ クエリ リーダーへのアクセスを提供します。 (継承元 BitmapMetadata) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| GetValue(DependencyProperty) |
DependencyObjectのこのインスタンスの依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject) |
| InvalidateProperty(DependencyProperty) |
指定した依存関係プロパティの有効な値を再評価します。 (継承元 DependencyObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnChanged() |
現在の Freezable オブジェクトが変更されたときに呼び出されます。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
設定したばかりの DependencyObjectType データ メンバーに対して適切なコンテキスト ポインターが確立されるようにします。 (継承元 Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
DependencyObjectのOnPropertyChanged(DependencyPropertyChangedEventArgs)実装をオーバーライドして、Changed型の依存関係プロパティの変化に応じてFreezable ハンドラーも呼び出します。 (継承元 Freezable) |
| ReadLocalValue(DependencyProperty) |
依存関係プロパティが存在する場合は、そのローカル値を返します。 (継承元 DependencyObject) |
| ReadPreamble() |
Freezableが有効なスレッドからアクセスされていることを確認します。 Freezableの継承子は、依存関係プロパティではないデータ メンバーを読み取る API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| RemoveQuery(String) |
BitmapMetadataのインスタンスからメタデータ クエリを削除します。 (継承元 BitmapMetadata) |
| SetCurrentValue(DependencyProperty, Object) |
値ソースを変更せずに依存関係プロパティの値を設定します。 (継承元 DependencyObject) |
| SetQuery(String, Object) |
ビットマップ イメージ ファイルにメタデータを書き込むことができるメタデータ クエリ ライターへのアクセスを提供します。 (継承元 BitmapMetadata) |
| SetValue(DependencyProperty, Object) |
依存関係プロパティ識別子で指定された依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
依存関係プロパティの DependencyPropertyKey 識別子で指定された、読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
シリアル化プロセスが指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| TrySave() |
イメージ メタデータを正常に保存できるかどうかを示す値を取得します。 |
| VerifyAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject) |
| WritePostscript() |
ChangedのFreezable イベントを発生させ、そのOnChanged() メソッドを呼び出します。 Freezableから派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する API の末尾でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| WritePreamble() |
Freezableが固定されていないこと、および有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable 継承子は、依存関係プロパティではないデータ メンバーに書き込む API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
イベント
| 名前 | 説明 |
|---|---|
| Changed |
Freezableまたはそれに含まれるオブジェクトが変更されたときに発生します。 (継承元 Freezable) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IEnumerable.GetEnumerator() |
このメンバーの説明については、 GetEnumerator()を参照してください。 (継承元 BitmapMetadata) |
| IEnumerable<String>.GetEnumerator() |
このメンバーの説明については、 GetEnumerator()を参照してください。 (継承元 BitmapMetadata) |
