ScriptString_pSize function (usp10.h)

Article
02/22/2024

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