ScriptStringGetLogicalWidths function (usp10.h)

Converts visual widths into logical widths.

Syntax

HRESULT ScriptStringGetLogicalWidths(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] int                    *piDx
);

Parameters

[in] ssa

A SCRIPT_STRING_ANALYSIS structure for the string.

[out] piDx

Pointer to a buffer in which this function retrieves logical widths. The buffer should have room for at least the number of integers indicated by the ssa parameter of ScriptString_pcOutChars.

Return value

Returns S_OK if successful. The function returns a nonzero HRESULT value if it does not succeed. The application can test the return value with the SUCCEEDED and FAILED macros.

Remarks

This function converts the visual widths generated by ScriptStringAnalyse into logical widths, one per original character, in logical order.

To use this function, the application needs to specify SSA_GLYPHS in its original call to ScriptStringAnalyse.

Important  Starting with Windows 8: To maintain the ability to run on Windows 7, a module that uses Uniscribe must specify Usp10.lib before gdi32.lib in its library list.
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header usp10.h
Library Usp10.lib
DLL Usp10.dll
Redistributable Internet Explorer 5 or later on Windows Me/98/95

See also

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

ScriptString_pcOutChars

Uniscribe

Uniscribe Functions