ID2D1Properties：：SetValueByName（PCWSTR，constT&） 方法（d2d1_1.h）

将命名属性设置为给定值。 这是模板重载。 请参阅“备注”。

语法

HRESULT SetValueByName(
  [in]      PCWSTR    propertyName,
  [in, ref] const T & value
);

参数

[in] propertyName

要设置的属性的名称。

[in, ref] value

要设置的数据。 在将此类型设置为属性值之前，该方法会将此类型转换为 BYTE* 。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。

HRESULT	描述
S_OK	未发生错误。
D2DERR_INVALID_PROPERTY	指定的属性不存在。
E_OUTOFMEMORY	未能分配必要的内存。
D3DERR_OUT_OF_VIDEO_MEMORY	未能分配所需的视频内存。
E_INVALIDARG	一个或多个参数无效。
E_FAIL	未指定的失败。

言论

template<typename T>
    HRESULT SetValueByName(
        _In_ PCWSTR propertyName,
        _In_ const T &value
        );

要求

要求	价值
最低支持的客户端	适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用]
支持的最低服务器	适用于 Windows Server 2008 R2 的 Windows Server 2012 和平台更新 [桌面应用 |UWP 应用]
目标平台	窗户
标头	d2d1_1.h
库	D2d1.lib
DLL	D2d1.dll

另请参阅

ID2D1Properties