Funzione ScriptStringXtoCP (usp10.h)

Converte una coordinata x in una posizione di carattere.

Sintassi

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Parametri

[in] ssa

Struttura SCRIPT_STRING_ANALYSIS per la stringa.

[in] iX

Coordinata x.

[out] piCh

Puntatore a una variabile in cui questa funzione recupera la posizione del carattere corrispondente alla coordinata x.

[out] piTrailing

Puntatore a una variabile in cui questa funzione recupera un valore che indica se la coordinata x è per il bordo principale o il bordo finale della posizione del carattere. Per altre informazioni, vedere la sezione Osservazioni.

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

Se la coordinata x corrisponde al bordo iniziale del carattere, il valore di piTrailing è 0. Se la coordinata x corrisponde al bordo finale del carattere, il valore di piTrailing è un intero positivo. Come per ScriptXtoCP, il valore è 1 per un carattere che può essere eseguito in modo autonomo. Il valore è maggiore di 1 se il carattere fa parte di un cluster in uno script per cui i cursori non vengono posizionati all'interno di un cluster, per indicare l'offset alla posizione del cursore logico legittimo successivo.

Se la coordinata x è prima dell'inizio della riga, la funzione recupera -1 per piCh e 1 per piTrailing, che indica il bordo finale del carattere inesistente prima della linea. Se la coordinata x è dopo la fine della riga, la funzione recupera per piCh il primo indice oltre la lunghezza della riga e 0 per piTrailing. Il valore 0 indica il bordo iniziale del carattere inesistente dopo la riga.

Requisiti

Vedi anche

SCRIPT_STRING_ANALYSIS

Uniscribe

Funzioni uniscrivere