ScriptString_pSize function (usp10.h)

Returns a pointer to a SIZE structure for an analyzed string.

Syntax

const SIZE * ScriptString_pSize(
  [in] SCRIPT_STRING_ANALYSIS ssa
);

Parameters

[in] ssa

A SCRIPT_STRING_ANALYSIS structure for a string.

Return value

Returns a pointer to a SIZE structure containing the size (width and height) of the analyzed string if successful. The function returns NULL if it does not succeed.

Remarks

The size returned by this function is the size before the effect of the justification requested by setting the SSA_FIT flag in ScriptStringAnalyse. The difference between the value of iReqWidth in ScriptStringAnalyse and the size returned by ScriptString_pSize is the effect of justification.

The pointer returned by this function is valid only until the application passes the associated SCRIPT_STRING_ANALYSIS structure to ScriptStringFree.

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

See also

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

ScriptStringFree

Uniscribe

Uniscribe Functions