Funzione ScriptApplyLogicalWidth (usp10.h)

Articolo
03/09/2024

Accetta una matrice di larghezze avanzate per un'esecuzione e genera una matrice di larghezza del glifo modificata.

Sintassi

HRESULT ScriptApplyLogicalWidth(
  [in]                const int             *piDx,
  [in]                int                   cChars,
  [in]                int                   cGlyphs,
  [in]                const WORD            *pwLogClust,
  [in]                const SCRIPT_VISATTR  *psva,
  [in]                const int             *piAdvance,
  [in]                const SCRIPT_ANALYSIS *psa,
  [in, out, optional] ABC                   *pABC,
  [out]               int                   *piJustify
);

Parametri

[in] piDx

Puntatore a una matrice di larghezze avanzate in ordine logico, uno per ogni punto di codice.

[in] cChars

Conteggio dei punti di codice logici nell'esecuzione.

[in] cGlyphs

Numero di glifi.

[in] pwLogClust

Puntatore a una matrice di cluster logici da ScriptShape.

[in] psva

Puntatore a una struttura SCRIPT_VISATTR da ScriptShape e aggiornata da ScriptPlace.

[in] piAdvance

Puntatore a una matrice di larghezza avanzata del glifo da ScriptPlace.

[in] psa

Puntatore a una struttura SCRIPT_ANALYSIS da ScriptItemize e aggiornata da ScriptShape e ScriptPlace.

[in, out, optional] pABC

Puntatore alla larghezza di ABC complessiva di un'esecuzione. In input, il parametro deve contenere le larghezze abc di esecuzione recuperate da ScriptPlace. Nell'output, il parametro indica la larghezza ABC aggiornata per corrispondere alle nuove larghezze.

[out] piJustify

Puntatore a una matrice in cui la funzione recupera le larghezze avanzate del glifo. Questa matrice è adatta per passare al parametro piJustify di ScriptTextOut.

Valore restituito

Restituisce 0 in caso di esito positivo. La funzione restituisce un valore HRESULT diverso da zero se non riesce. L'applicazione può testare il valore restituito con le macro SUCCESSED e FAILED .

Commenti

Questa funzione può essere usata per riapplicare le larghezze logiche ottenute con ScriptGetLogicalWidths. Può essere utile in situazioni come metafiling, per cui le informazioni di larghezza avanzata devono essere registrate e riapplicate in modo indipendente dal tipo di carattere, indipendentemente dalla sostituzione del glifo, ad esempio la legatura.

Importante A partire da Windows 8: per mantenere la possibilità di eseguire in Windows 7, un modulo che usa Uniscribe deve specificare Usp10.lib prima di gdi32.lib nell'elenco delle librerie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	usp10.h
Libreria	Usp10.lib
DLL	Usp10.dll
Componente ridistribuibile	Internet Explorer 5 o versione successiva in Windows Me/98/95