IDWriteTextLayout1::SetCharacterSpacing method (dwrite_1.h)

Sets the spacing between characters.

Syntax

HRESULT SetCharacterSpacing(
  FLOAT             leadingSpacing,
  FLOAT             trailingSpacing,
  FLOAT             minimumAdvanceWidth,
  DWRITE_TEXT_RANGE textRange
);

Parameters

leadingSpacing

Type: FLOAT

The spacing before each character, in reading order.

trailingSpacing

Type: FLOAT

The spacing after each character, in reading order.

minimumAdvanceWidth

Type: FLOAT

The minimum advance of each character, to prevent characters from becoming too thin or zero-width. This must be zero or greater.

textRange

Type: DWRITE_TEXT_RANGE

Text range to which this change applies.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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 dwrite_1.h
Library Dwrite.lib
DLL Dwrite.dll

See also

IDWriteTextLayout1