The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ID2D1DeviceContext::DrawGlyphRun method

Draws a series of glyphs to the device context.

Syntax

C++


void DrawGlyphRun(
                       D2D1_POINT_2F                baselineOrigin,
  [in]           const DWRITE_GLYPH_RUN             *glyphRun,
  [in, optional] const DWRITE_GLYPH_RUN_DESCRIPTION *glyphRunDescription,
  [in]                 ID2D1Brush                   *foregroundBrush,
                       DWRITE_MEASURING_MODE        measuringMode
);

Parameters

baselineOrigin

Type: D2D1_POINT_2F

Origin of first glyph in the series.

glyphRun [in]

Type: const DWRITE_GLYPH_RUN*

The glyphs to render.

glyphRunDescription [in, optional]

Type: const DWRITE_GLYPH_RUN_DESCRIPTION*

Supplementary glyph series information.

foregroundBrush [in]

Type: ID2D1Brush*

The brush that defines the text color.

measuringMode

Type: DWRITE_MEASURING_MODE

The measuring mode of the glyph series, used to determine the advances and offsets. The default value is DWRITE_MEASURING_MODE_NATURAL.

Return value

This method does not return a value.

Remarks

The glyphRunDescription is ignored when rendering, but can be useful for printing and serialization of rendering commands, such as to an XPS or SVG file. This extends ID2D1RenderTarget::DrawGlyphRun, which lacked the glyph run description.

Requirements

Minimum supported client	Windows 8 and Platform Update for Windows 7 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps \| Windows Store apps]
Minimum supported phone	Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]
Header	D2d1_1.h
DLL	D2d1.dll