Partilhar via


Usando as funções ScriptString

Para um aplicativo que lida com texto não formatado, o Uniscribe fornece as funções ScriptString*. Essas funções são semelhantes a ExtTextOut, DrawTexte GetTextExtent, mas fornecem suporte completo a scripts complexos, incluindo o posicionamento do cursor. Estas funções são semelhantes às outras funções Uniscribe, mas são adaptadas aos requisitos mais simples do processamento de texto simples.

A tabela a seguir detalha as funções de ScriptString* e quaisquer contrapartes nas outras funções Uniscribe.

Função Descrição
ScriptStringAnalyse Analisa texto simples. Esta função corresponde às seguintes funções:
ScriptItemize
ScriptShape
ScriptPlace
ScriptBreak
ScriptGetCMap
ScriptJustifique
ScriptLayout
ScriptStringCPtoX Recupera a coordenada x para uma posição de caractere. Esta função corresponde a ScriptCPtoX.
ScriptStringFree Liberta uma estrutura SCRIPT_STRING_ANALYSIS.
ScriptStringGetLogicalWidths Converte larguras visuais em larguras lógicas. Esta função corresponde a ScriptGetLogicalWidths.
ScriptStringGetOrder Mapeia as posições dos glifos de caracteres de forma semelhante ao GetCharacterPlacement, apenas para uso legado. Esta função não funciona bem com scripts que geram mais de um glifo por ponto de código.
ScriptStringOut Exibe texto sem formatação. Esta função corresponde a ScriptTextOut.
ScriptString_pcOutChars Retorna um ponteiro para o comprimento de uma cadeia de caracteres de texto sem formatação cortada.
ScriptString_pLogAttr Retorna um ponteiro para o buffer de atributos lógicos de uma cadeia de texto simples analisada.
ScriptString_pSize Retorna um ponteiro para o tamanho (largura e altura) de uma cadeia de caracteres de texto sem formatação analisada.
ScriptStringValidate Identifica sequências de pontos de código não válidas no script fornecido. Essa função é diferente de ScriptGetCMap, que identifica pontos de código não presentes em uma fonte.
ScriptStringXtoCP Converte uma coordenada x em uma posição de caractere. Esta função corresponde a ScriptXtoCP.

Para exibir apenas texto simples sem quaisquer modificações, um aplicativo deve chamar ScriptStringAnalyse, ScriptStringOute, em seguida, ScriptStringFree. As outras funções são usadas para modificar o texto sem formatação antes da exibição.

Usando o Uniscribe