BitmapProperties.SetPropertiesAsync 方法

定义

异步设置一个或多个位图属性。

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 属性或元数据查询的字符串,相应的值为 BitmapTypedValue ,其中包含数据和正确的 PropertyType

返回

异步管理位图属性设置的对象。

属性

注解

使用 BitmapPropertySet 存储要在编码器上设置的元数据项。 每个元数据项都是一个键值对。

键是一个字符串,用于标识要设置的元数据项。 BitmapEncoder 接受某些 Windows 属性以及使用 WIC 元数据查询语言构造的查询。 有关支持的 Windows 属性的列表,请参阅 支持的 Windows 属性。 有关支持的 WIC 元数据查询的摘要,请参阅 WIC 本机图像格式元数据查询 主题。

该值是 BitmapTypedValue ,可用于将实际元数据值与 Windows.Foundation.PropertyType) (显式数据类型相关联。

每种图像格式对每个位图属性的类型都有特定的要求,必须确保为每个 BitmapTypedValueType 字段正确设置所选属性。 例如, System.Photo.Orientation Windows 属性以 UInt16 的形式存储在文件中,因此必须将 “类型” 字段设置为 UInt16。 有关 Windows 属性类型的详细信息,请参阅 照片元数据策略。 有关 Windows 映像组件元数据查询类型的详细信息,请参阅 本机图像格式元数据查询

适用于

另请参阅