BitmapProperties.SetPropertiesAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Graphics.Imaging
編集

1 つ以上のビットマップ プロパティを非同期的に設定します。

public:
 virtual IAsyncAction ^ SetPropertiesAsync(IIterable<IKeyValuePair<Platform::String ^, BitmapTypedValue ^> ^> ^ propertiesToSet) = SetPropertiesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction SetPropertiesAsync(IIterable<IKeyValuePair<winrt::hstring, BitmapTypedValue const&>> const& propertiesToSet);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction SetPropertiesAsync(IEnumerable<KeyValuePair<string,BitmapTypedValue>> propertiesToSet);
function setPropertiesAsync(propertiesToSet)
Public Function SetPropertiesAsync (propertiesToSet As IEnumerable(Of KeyValuePair(Of String, BitmapTypedValue))) As IAsyncAction

パラメーター

propertiesToSet

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

IIterable<IKeyValuePair<Platform::String,BitmapTypedValue>>

IIterable<IKeyValuePair<winrt::hstring,BitmapTypedValue>>

設定するビットマップ プロパティを表すキーと値のペアのコレクション。 各キーは、Windows プロパティまたはメタデータ クエリを含む文字列であり、対応する値は、データと正しい PropertyType を含む BitmapTypedValue です。

戻り値

IAsyncAction

ビットマップ プロパティの設定を非同期的に管理する オブジェクト。

属性
RemoteAsyncAttribute

注釈

BitmapPropertySet を使用して、エンコーダーに設定するメタデータ項目を格納します。 各メタデータ項目はキーと値のペアです。

キーは、設定するメタデータ項目を識別する文字列です。 BitmapEncoder は、一部の Windows プロパティと、WIC メタデータ クエリ言語を使用して構築されたクエリを受け入れます。 サポートされている Windows プロパティの一覧については、「 サポートされている Windows プロパティ」を参照してください。 サポートされている WIC メタデータ クエリの概要については、 WIC ネイティブ イメージ形式メタデータ クエリ に関するトピックを参照してください。

値は BitmapTypedValue です。これにより、実際のメタデータ値を明示的なデータ型 (Windows.Foundation.PropertyType) に関連付けることができます。

各イメージ形式には、すべてのビットマップ プロパティの種類に関する特定の要件があり、選択したプロパティに対して各 BitmapTypedValue の Type フィールドが正しく設定されていることを確認する必要があります。 たとえば、 System.Photo.Orientation Windows プロパティは UInt16 としてファイルに格納されるため、 Type フィールドを UInt16 に設定する必要があります。 Windows プロパティの種類の詳細については、「 写真メタデータ ポリシー」を参照してください。 Windows Imaging コンポーネントのメタデータ クエリの種類の詳細については、「 ネイティブ イメージ形式のメタデータ クエリ」を参照してください。

適用対象

こちらもご覧ください