Funzione ScriptStringGetOrder (usp10.h)

Articolo
08/26/2023

Crea una matrice che esegue il mapping di una posizione di carattere originale a una posizione del glifo.

Sintassi

HRESULT ScriptStringGetOrder(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] UINT                   *puOrder
);

Parametri

[in] ssa

Struttura SCRIPT_STRING_ANALYSIS per la stringa.

[out] puOrder

Puntatore a un buffer in cui questa funzione recupera una matrice di posizioni del glifo, indicizzate dalla posizione del carattere originale. La matrice deve avere spazio per almeno il numero di interi indicati dal parametro ssa di ScriptString_pcOutChars.

Valore restituito

Restituisce S_OK se riuscito. 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

Quando il numero di glifi e il numero di caratteri sono uguali, la funzione recupera una matrice che fa riferimento a ogni glifo. Si tratta dello stesso trattamento che si verifica in GetCharacterPlacement.

Per usare questa funzione, l'applicazione deve specificare SSA_GLYPHS nella chiamata originale a ScriptStringAnalyse.

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


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