Função ScriptIsComplex (usp10.h)

  • Artigo

Determina se uma cadeia de caracteres Unicode requer processamento de script complexo.

Sintaxe

HRESULT ScriptIsComplex(
  [in] const WCHAR *pwcInChars,
  [in] int         cInChars,
  [in] DWORD       dwFlags
);

Parâmetros

[in] pwcInChars

Ponteiro para a cadeia de caracteres a ser testada.

[in] cInChars

Comprimento da cadeia de caracteres de entrada, em caracteres.

[in] dwFlags

Sinalizadores que especificam detalhes de teste. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
SIC_ASCIIDIGIT
 Trate os dígitos U+0030 a U+0039 como complexos. O aplicativo define esse sinalizador se a cadeia de caracteres for exibida com a substituição de dígito habilitada. Se o aplicativo estiver seguindo as configurações do NLS (Suporte nacional à linguagem) do usuário usando a função ScriptRecordDigitSubstitution , ele poderá passar uma estrutura de SCRIPT_DIGITSUBSTITUTE com o membro DigitSubstitute definido como SCRIPT_DIGITSUBSTITUTE_NONE.
SIC_COMPLEX
 Trate letras de script complexas como complexas. Normalmente, esse sinalizador deve ser definido.
SIC_NEUTRAL
 Trate os neutros como complexos. O aplicativo define esse sinalizador para exibir a cadeia de caracteres com ordem de leitura da direita para a esquerda.

Retornar valor

Retorna S_OK se a cadeia de caracteres exigir processamento de script complexo. A função retornará S_FALSE se a cadeia de caracteres puder ser manipulada por chamadas de função de API padrão, ou seja, ela conterá apenas caracteres dispostos lado a lado e da esquerda para a direita. A função retornará um valor HRESULT diferente de zero se não for bem-sucedida.

Comentários

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

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

Confira também

Exibindo texto com Uniscribe

SCRIPT_DIGITSUBSTITUTE

ScriptRecordDigitSubstitution

Uniscribe

Funções Uniscribe