UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:usp10.ScriptApplyLogicalWidth

ScriptApplyLogicalWidth function (usp10.h)

Takes an array of advance widths for a run and generates an array of adjusted advance glyph widths.

ScriptApplyLogicalWidth

ScriptApplyLogicalWidth function [Internationalization for Windows Applications]

_win32_ScriptApplyLogicalWidth

intl.scriptapplylogicalwidth

usp10/ScriptApplyLogicalWidth

intl\scriptapplylogicalwidth.htm

Intl

964634f4-700b-47a7-a86f-071f1c97bcbe

12/05/2018

ScriptApplyLogicalWidth, ScriptApplyLogicalWidth function [Internationalization for Windows Applications], _win32_ScriptApplyLogicalWidth, intl.scriptapplylogicalwidth, usp10/ScriptApplyLogicalWidth

usp10.h

Windows

Windows 2000 Professional [desktop apps only]

Windows 2000 Server [desktop apps only]

Usp10.lib

Usp10.dll

Windows

Internet Explorer 5 or later on Windows Me/98/95

19H1

ScriptApplyLogicalWidth

usp10/ScriptApplyLogicalWidth

c++

APIRef

kbSyntax

DllExport

usp10.dll

Ext-MS-Win-GDI-Internal-Desktop-L1-1-0.dll

GDI32.dll

GDI32Full.dll

ScriptApplyLogicalWidth

ScriptApplyLogicalWidth function

-description

Takes an array of advance widths for a run and generates an array of adjusted advance glyph widths.

-parameters

-param piDx [in]

Pointer to an array of advance widths in logical order, one per code point.

-param cChars [in]

Count of the logical code points in the run.

-param cGlyphs [in]

Glyph count.

-param pwLogClust [in]

Pointer to an array of logical clusters from ScriptShape.

-param psva [in]

Pointer to a SCRIPT_VISATTR structure from ScriptShape and updated by ScriptPlace.

-param piAdvance [in]

Pointer to an array of glyph advance widths from ScriptPlace.

-param psa [in]

Pointer to a SCRIPT_ANALYSIS structure from ScriptItemize and updated by ScriptShape and ScriptPlace.

-param pABC [in, out, optional]

Pointer to the overall ABC width of a run. On input, the parameter should contain the run ABC widths retrieved by ScriptPlace. On output, the parameter indicates the ABC width updated to match the new widths.

-param piJustify [out]

Pointer to an array in which the function retrieves the glyph advance widths. This array is suitable for passing to the piJustify parameter of ScriptTextOut.

-returns

Returns 0 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 can be used to reapply logical widths obtained with ScriptGetLogicalWidths. It can be useful in situations such as metafiling, for which advance width information must be recorded and reapplied in a font-independent manner, independent of glyph substitutions, such as ligaturization.

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.