StringFormat::SetMeasurableCharacterRanges method (gdiplusstringformat.h)

The StringFormat::SetMeasurableCharacterRanges method sets a series of character ranges for this StringFormat object that, when in a string, can be measured by the MeasureCharacterRanges method.

Syntax

Status SetMeasurableCharacterRanges(
  [in] INT                  rangeCount,
  [in] const CharacterRange *ranges
);

Parameters

[in] rangeCount

Type: INT

Integer that specifies the number of character ranges in the ranges array (no more than 32).

[in] ranges

Type: const CharacterRange*

Pointer to an array of CharacterRange objects that specify the character ranges to be measured.

Return value

Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusstringformat.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also

MeasureCharacterRanges

StringFormat

StringFormat::GetMeasurableCharacterRangeCount