Función ScriptCPtoX (usp10.h)

Artículo
03/09/2024

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.

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