ID2D1DeviceContext::GetGlyphRunWorldBounds method (d2d1_1.h)

Gets the world-space bounds in DIPs of the glyph run using the device context DPI.

Syntax

HRESULT GetGlyphRunWorldBounds(
        D2D1_POINT_2F          baselineOrigin,
  [in]  const DWRITE_GLYPH_RUN *glyphRun,
        DWRITE_MEASURING_MODE  measuringMode,
  [out] D2D1_RECT_F            *bounds
);

Parameters

baselineOrigin

Type: D2D1_POINT_2F

The origin of the baseline for the glyph run.

[in] glyphRun

Type: const DWRITE_GLYPH_RUN*

The glyph run to render.

measuringMode

Type: DWRITE_MEASURING_MODE

The DirectWrite measuring mode that indicates how glyph metrics are used to measure text when it is formatted.

[out] bounds

Type: D2D1_RECT_F*

The bounds of the glyph run in DIPs and in world space.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid parameter was passed to the returning function.

Remarks

The image bounds reflect the current DPI, unit mode, and world transform of the context.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1_1.h
DLL D2d1.dll

See also

ID2D1DeviceContext