IDWriteTextRenderer::D rawGlyphRun 方法 (dwrite.h)

IDWriteTextLayout::Draw 调用此函数以指示客户端呈现字形运行。

语法

HRESULT DrawGlyphRun(
       void                               *clientDrawingContext,
       FLOAT                              baselineOriginX,
       FLOAT                              baselineOriginY,
       DWRITE_MEASURING_MODE              measuringMode,
  [in] DWRITE_GLYPH_RUN const             *glyphRun,
  [in] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
       IUnknown                           *clientDrawingEffect
);

参数

clientDrawingContext

类型: void*

传递给 IDWriteTextLayout::D raw 的应用程序定义的绘图上下文。

baselineOriginX

类型: FLOAT

像素位置 (X 坐标) 字形运行的基线原点处。

baselineOriginY

类型: FLOAT

像素位置 (字形运行的基线原点处) Y 坐标。

measuringMode

类型: DWRITE_MEASURING_MODE

运行中字形的测量方法,与其他属性一起使用以确定呈现模式。

[in] glyphRun

类型: const DWRITE_GLYPH_RUN*

指向要呈现的字形运行实例的指针。

[in] glyphRunDescription

类型: const DWRITE_GLYPH_RUN_DESCRIPTION*

指向字形运行说明实例的指针,该实例包含与此运行关联的字符的属性。

clientDrawingEffect

类型: IUnknown*

要呈现的字形的应用程序定义的绘图效果。 通常,此参数表示填充文本内部的前景画笔等效果。

返回值

类型: HRESULT

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

注解

IDWriteTextLayout::D raw 函数调用此回调函数,其中包含要呈现的字形的所有信息。 应用程序通过主要委托对基础平台图形 API(如 Direct2D )的调用在绘图上下文上绘制字形来实现此回调。 使用 GDI 的应用程序可以根据 IDWriteBitmapRenderTarget::D rawGlyphRun 方法实现此回调。

要求

要求
最低受支持的客户端 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

另请参阅

IDWriteTextRenderer