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