Función ScriptStringXtoCP (usp10.h)

  • Artículo

Convierte una coordenada x en una posición de carácter.

Sintaxis

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

Parámetros

[in] ssa

Estructura SCRIPT_STRING_ANALYSIS de la cadena.

[in] iX

La coordenada X.

[out] piCh

Puntero a una variable en la que esta función recupera la posición del carácter correspondiente a la coordenada x.

[out] piTrailing

Puntero a una variable en la que esta función recupera un valor que indica si la coordenada x es para el borde inicial o el borde final de la posición del carácter. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. La 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

Si la coordenada x corresponde al borde inicial del carácter, el valor de piTrailing es 0. Si la coordenada x corresponde al borde final del carácter, el valor de piTrailing es un entero positivo. En cuanto a ScriptXtoCP, el valor es 1 para un carácter que se puede representar por sí mismo. El valor es mayor que 1 si el carácter forma parte de un clúster en un script para el que los cursores no se colocan dentro de un clúster, para indicar el desplazamiento a la siguiente posición lógica legítima del cursor.

Si la coordenada x está antes del principio de la línea, la función recupera -1 para piCh y 1 para piTrailing, lo que indica el borde final del carácter inexistente antes de la línea. Si la coordenada x está después del final de la línea, la función recupera para piCh el primer índice más allá de la longitud de la línea y 0 para piTrailing. El valor 0 indica el borde inicial del carácter inexistente después de la línea.

Importante A partir de Windows 8: para mantener la capacidad de ejecutarse en Windows 7, un módulo que usa Uniscribe debe especificar Usp10.lib antes de gdi32.lib en su lista de bibliotecas.
 

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

Consulte también

SCRIPT_STRING_ANALYSIS

Uniscribe

Funciones uniscribe