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.

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

Vedi anche

SCRIPT_STRING_ANALYSIS

Uniscribe

Funzioni uniscrivere