IDWritePaintReader：：SetCurrentGlyph (UINT32，DWRITE_PAINT_ELEMENT*，UINT32，D2D_RECT_F*，DWRITE_PAINT_ATTRIBUTES*) 方法 (dwrite_3.h)

设置当前字形，并将读取器定位在所选字形可视化树的根画图元素上。

语法

HRESULT SetCurrentGlyph(
  UINT32                  glyphIndex,
  DWRITE_PAINT_ELEMENT    *paintElement,
  UINT32                  structSize,
  D2D_RECT_F              *clipBox,
  DWRITE_PAINT_ATTRIBUTES *glyphAttributes
);

参数

glyphIndex

类型： UINT32

要获取其标志符号表示形式的字形索引。

paintElement

类型：_Out_writes_bytes_ (structSize) DWRITE_PAINT_ELEMENT *

接收有关标志符号可视化树的根画图元素的信息。

structSize

类型： UINT32

DWRITE_PAINT_ELEMENT 结构的大小（以字节为单位）。

clipBox

类型：_Out_ D2D_RECT_F *

接收指定字形的预计算字形框 (，如果指定字形是由字体指定的，则以 ems) 。 否则，字形框设置为空矩形， (所有零) 。 如果指定了非空剪裁框，则必须将颜色标志符号的表示形式剪裁到指定的框。

glyphAttributes

类型：_Out_opt_ DWRITE_PAINT_ATTRIBUTES * = nullptr

接收字形的可选绘制属性。

返回值

标准 HRESULT 错误代码。

注解

如果指定的字形索引不是颜色标志符号，则该方法成功，但 DWRITE_PAINT_ELEMENT 结构的 paintType 成员设置为 DWRITE_PAINT_TYPE_NONE。 在这种情况下，应将输入字形绘制为非颜色字形。

要求

要求	值
最低受支持的客户端	使用 Windows 应用 SDK 1.2 或更高版本的 Windows 10 版本 1809 ()
标头	dwrite_3.h