BitmapProperties.SetPropertiesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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<Platform::String,BitmapTypedValue>>
IIterable<IKeyValuePair<winrt::hstring,BitmapTypedValue>>
設定するビットマップ プロパティを表すキーと値のペアのコレクション。 各キーは、Windows プロパティまたはメタデータ クエリを含む文字列であり、対応する値は、データと正しい PropertyType を含む BitmapTypedValue です。
戻り値
ビットマップ プロパティの設定を非同期的に管理する オブジェクト。
- 属性
注釈
BitmapPropertySet を使用して、エンコーダーに設定するメタデータ項目を格納します。 各メタデータ項目はキーと値のペアです。
キーは、設定するメタデータ項目を識別する文字列です。 BitmapEncoder は、一部の Windows プロパティと、WIC メタデータ クエリ言語を使用して構築されたクエリを受け入れます。 サポートされている Windows プロパティの一覧については、「 サポートされている Windows プロパティ」を参照してください。 サポートされている WIC メタデータ クエリの概要については、 WIC ネイティブ イメージ形式メタデータ クエリ に関するトピックを参照してください。
値は BitmapTypedValue です。これにより、実際のメタデータ値を明示的なデータ型 (Windows.Foundation.PropertyType) に関連付けることができます。
各イメージ形式には、すべてのビットマップ プロパティの種類に関する特定の要件があり、選択したプロパティに対して各 BitmapTypedValue の Type フィールドが正しく設定されていることを確認する必要があります。 たとえば、 System.Photo.Orientation Windows プロパティは UInt16 としてファイルに格納されるため、 Type フィールドを UInt16 に設定する必要があります。 Windows プロパティの種類の詳細については、「 写真メタデータ ポリシー」を参照してください。 Windows Imaging コンポーネントのメタデータ クエリの種類の詳細については、「 ネイティブ イメージ形式のメタデータ クエリ」を参照してください。