IDWriteTextLayout::D raw 方法 (dwrite.h)

使用指定的客户端绘图上下文绘制文本。

语法

HRESULT Draw(
  void                *clientDrawingContext,
  IDWriteTextRenderer *renderer,
  FLOAT               originX,
  FLOAT               originY
);

参数

clientDrawingContext

类型: void*

应用程序定义的绘图上下文。

renderer

类型: IDWriteTextRenderer*

指向用于绘制文本字符串部分的回调函数集的指针。

originX

类型: FLOAT

布局左侧的 x 坐标。

originY

类型: FLOAT

布局顶部的 y 坐标。

返回值

类型: HRESULT

如果此方法成功,它将返回 S_OK。 否则,它将返回 HRESULT 错误代码。

注解

若要使用此方法绘制文本,需要使用 IDWriteFactory::CreateTextLayout 的应用程序创建 textLayout 对象。

获取 textLayout 对象后,应用程序调用 IDWriteTextLayout::D raw 方法来绘制文本、修饰和内联对象。 实际绘图是通过作为 textRenderer 参数传入的回调接口完成的;在那里,将调用相应的 DrawGlyphRun API。

如果通过 SetReadingDirection 在 IDWriteTextLayout 上设置垂直文本阅读方向,DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (或从底部到顶部) ,则必须传递实现 IDWriteTextRenderer1 的接口。 否则,会收到错误DWRITE_E_TEXTRENDERERINCOMPATIBLE,因为原始 IDWriteTextRenderer 接口仅支持水平文本。

要求

   
最低受支持的客户端 适用于 Windows Vista 的 Windows 7、带 SP2 和平台更新的 Windows Vista [桌面应用|UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和平台更新的 Windows Server 2008 [桌面应用|UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteTextLayout