Função ScriptBreak (usp10.h)

Artigo
03/03/2024

Recupera informações para determinar quebras de linha.

Sintaxe

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

Parâmetros

[in] pwcChars

Ponteiro para os caracteres Unicode a serem processados.

[in] cChars

Número de caracteres Unicode a serem processados.

[in] psa

Ponteiro para a estrutura SCRIPT_ANALYSIS obtida de uma chamada anterior para ScriptItemize.

[out] psla

Ponteiro para um buffer no qual essa função recupera os atributos de caractere como uma estrutura SCRIPT_LOGATTR .

Retornar valor

Retorna 0 se for bem-sucedido. A função retornará um valor HRESULT diferente de zero se não for bem-sucedida. O aplicativo pode testar o valor retornado com as macros SUCCEEDED e FAILED .

Comentários

Consulte Exibindo texto com Uniscribe para ver uma discussão sobre o contexto no qual essa função normalmente é chamada.

Essa função não requer um contexto de dispositivo e não executa a formatação de glifo.

Essa função recupera o movimento do cursor e as posições de quebra de formatação de um item em uma matriz de estruturas SCRIPT_LOGATTR . Para dar suporte à formatação mista em uma única palavra corretamente, a chamada para ScriptBreak deve passar itens inteiros conforme recuperado por ScriptItemize e não a formatação mais fina é executada.

A estrutura SCRIPT_LOGATTR identifica posições de cursor válidas e quebras de linha. O membro fCharStop especifica um sinalizador que marca os limites do cluster para scripts que são convencionalmente impedidos de se mover dentro de clusters. Os mesmos limites também podem ser inferidos inspecionando as informações de cluster lógico recuperadas por ScriptShape. No entanto, o ScriptBreak é consideravelmente mais rápido na implementação e não exige que um contexto de dispositivo seja preparado.

Os sinalizadores designados pelos membros fWordStop, fSoftBreak e fWhiteSpace de SCRIPT_LOGATTR só estão disponíveis por meio do ScriptBreak.

A maioria dos mecanismos de formatação que identificam sequências inválidas definem o sinalizador indicado pelo membro fInvalid do SCRIPT_LOGATTR no ScriptBreak. O membro fInvalidLogAttr do SCRIPT_PROPERTIES identifica os scripts aplicáveis.

Importante Começando com Windows 8: para manter a capacidade de execução no Windows 7, um módulo que usa Uniscribe deve especificar Usp10.lib antes de gdi32.lib em sua lista de bibliotecas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	usp10.h
Biblioteca	Usp10.lib
DLL	Usp10.dll
Redistribuível	Internet Explorer 5 ou posterior no Windows Me/98/95