Função ScriptBreak (usp10.h)
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.
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 |