Funzione ScriptCPtoX (usp10.h)

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.

Requisiti

Vedi anche

SCRIPT_ANALYSIS

SCRIPT_VISATTR

ScriptXtoCP

Uniscribe

Funzioni Uniscribe