Función ScriptCPtoX (usp10.h)
Genera el desplazamiento x desde el extremo izquierdo o el borde inicial de una ejecución hasta el borde inicial o final de un clúster de caracteres lógicos.
Sintaxis
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
);
Parámetros
[in] iCP
Posición del carácter lógico en la ejecución. Este parámetro corresponde al desplazamiento de cualquier carácter lógico del clúster.
[in] fTrailing
TRUE para usar el borde final del clúster de caracteres lógicos para calcular el desplazamiento. Este parámetro se establece en FALSE para usar el borde inicial del clúster de caracteres lógicos.
[in] cChars
Número de caracteres de la ejecución.
[in] cGlyphs
Número de glifos en la ejecución.
[in] pwLogClust
Puntero a los clústeres lógicos.
[in] psva
Puntero a una matriz de SCRIPT_VISATTR de atributos visuales.
[in] piAdvance
Puntero a un valor de ancho avanzado.
[in] psa
Puntero a una estructura de SCRIPT_ANALYSIS . El miembro fLogicalOrder especifica el final de la ejecución desde la que se va a medir el desplazamiento. Si se establece la marca, se usa el borde inicial de la ejecución. Si no se establece la marca, se usa el extremo izquierdo de la ejecución.
[out] piX
Puntero al búfer en el que la función recupera la posición x del símbolo de intercalación.
Valor devuelto
Si la operación se realiza correctamente, devuelve 0. Esta función devuelve un valor HRESULT distinto de cero si no se realiza correctamente. La aplicación puede probar el valor devuelto con las macros SUCCEEDED y FAILED .
Comentarios
El borde inicial o final del carácter y el borde inicial de una ejecución dependen de la dirección del texto de la ejecución.
En el caso de los scripts en los que el símbolo de intercalación se coloca convencionalmente en medio de clústeres (por ejemplo, árabe y hebreo), la posición x recuperada del carat puede ser una posición interpolada para cualquier punto de código de la línea.
En el caso de los scripts en los que el símbolo de intercalación se ajusta convencionalmente a los límites de los clústeres (por ejemplo, tailandés e indio), la posición x se ajusta al borde solicitado del clúster que contiene la posición del carácter lógico indicada por iCP.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | usp10.h |
| Library | Usp10.lib |
| Archivo DLL | Usp10.dll |
| Redistribuible | Internet Explorer 5 o posterior en Windows Me/98/95 |