Función ScriptBreak (usp10.h)

Artículo
03/03/2024

Recupera información para determinar los saltos de línea.

Sintaxis

HRESULT ScriptBreak(
  [in]  const WCHAR           *pwcChars,
  [in]  int                   cChars,
  [in]  const SCRIPT_ANALYSIS *psa,
  [out] SCRIPT_LOGATTR        *psla
);

Parámetros

[in] pwcChars

Puntero a los caracteres Unicode que se van a procesar.

[in] cChars

Número de caracteres Unicode que se van a procesar.

[in] psa

Puntero a la estructura SCRIPT_ANALYSIS obtenida de una llamada anterior a ScriptItemize.

[out] psla

Puntero a un búfer en el que esta función recupera los atributos de carácter como una estructura de SCRIPT_LOGATTR .

Valor devuelto

Si la operación se realiza correctamente, devuelve 0. 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

Vea Mostrar texto con Uniscribe para obtener una explicación del contexto en el que normalmente se llama a esta función.

Esta función no requiere un contexto de dispositivo y no realiza la forma del glifo.

Esta función recupera las posiciones de salto de formato y movimiento del cursor para un elemento de una matriz de estructuras de SCRIPT_LOGATTR . Para admitir el formato mixto dentro de una sola palabra correctamente, la llamada a ScriptBreak debe pasar elementos enteros tal como lo recupera ScriptItemize y no se ejecuta el formato más fino.

La estructura de SCRIPT_LOGATTR identifica posiciones de intercalación y saltos de línea válidos. El miembro fCharStop especifica una marca que marca los límites del clúster para los scripts que se restringen convencionalmente al moverse dentro de los clústeres. También se pueden deducir los mismos límites inspeccionando la información del clúster lógico recuperada por ScriptShape. Sin embargo, ScriptBreak es considerablemente más rápido en la implementación y no requiere que se prepare un contexto de dispositivo.

Las marcas designadas por los miembros fWordStop, fSoftBreak y fWhiteSpace de SCRIPT_LOGATTR solo están disponibles a través de ScriptBreak.

La mayoría de los motores de modelado que identifican secuencias no válidas establecen la marca indicada por el miembro fInvalid de SCRIPT_LOGATTR en ScriptBreak. El miembro fInvalidLogAttr de SCRIPT_PROPERTIES identifica los scripts aplicables.

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