Funzione ScriptCPtoX (usp10.h)

Articolo
03/03/2024

Genera l'offset x dall'estremità sinistra o dal bordo iniziale di un'esecuzione al bordo iniziale o finale di un cluster di caratteri logici.

Sintassi

HRESULT ScriptCPtoX(
  [in]  int                   iCP,
  [in]  BOOL                  fTrailing,
  [in]  int                   cChars,
  [in]  int                   cGlyphs,
  [in]  const WORD            *pwLogClust,
  [in]  const SCRIPT_VISATTR  *psva,
  [in]  const int             *piAdvance,
  [in]  const SCRIPT_ANALYSIS *psa,
  [out] int                   *piX
);

Parametri

[in] iCP

Posizione del carattere logico nell'esecuzione. Questo parametro corrisponde all'offset di qualsiasi carattere logico nel cluster.

[in] fTrailing

TRUE per usare il bordo finale del cluster di caratteri logici per calcolare l'offset. Questo parametro è impostato su FALSE per usare il bordo iniziale del cluster di caratteri logici.

[in] cChars

Numero di caratteri nell'esecuzione.

[in] cGlyphs

Numero di glifi nell'esecuzione.

[in] pwLogClust

Puntatore ai cluster logici.

[in] psva

Puntatore a una matrice SCRIPT_VISATTR di attributi visivi.

[in] piAdvance

Puntatore a un valore di larghezza avanzata.

[in] psa

Puntatore a una struttura SCRIPT_ANALYSIS . Il membro fLogicalOrder specifica la fine dell'esecuzione da cui misurare l'offset. Se il flag è impostato, viene usato il bordo iniziale dell'esecuzione. Se il flag non è impostato, viene utilizzata la fine sinistra dell'esecuzione.

[out] piX

Puntatore al buffer in cui la funzione recupera la posizione x del cursore.

Valore restituito

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

Commenti

Il bordo iniziale o finale del carattere e il bordo iniziale di una corsa dipendono dalla direzione del testo nella sequenza.

Per gli script in cui il cursore viene posizionato convenzionalmente al centro dei cluster (ad esempio, arabo ed ebraico), la posizione x recuperata del carato può essere una posizione interpolata per qualsiasi punto di codice nella riga.

Per gli script in cui il cursore viene ritagliato convenzionalmente fino ai limiti dei cluster (ad esempio, Thai e Indiano), la posizione x viene inserita nel bordo richiesto del cluster contenente la posizione del carattere logico indicata da iCP.

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 di 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

Vedi anche

Condividi tramite