Função ScriptStringXtoCP (usp10.h)

  • Artigo

Converte uma coordenada x em uma posição de caractere.

Sintaxe

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Parâmetros

[in] ssa

Uma estrutura SCRIPT_STRING_ANALYSIS para a cadeia de caracteres.

[in] iX

A coordenada x.

[out] piCh

Ponteiro para uma variável na qual essa função recupera a posição do caractere correspondente à coordenada x.

[out] piTrailing

Ponteiro para uma variável na qual essa função recupera um valor que indica se a coordenada x é para a borda à esquerda ou para a borda à direita da posição do caractere. Para obter mais informações, consulte a seção Comentários.

Retornar valor

Retorna S_OK se tiver êxito. 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

Se a coordenada x corresponder à borda superior do caractere, o valor de piTrailing será 0. Se a coordenada x corresponder à borda à direita do caractere, o valor de piTrailing será um inteiro positivo. Quanto a ScriptXtoCP, o valor é 1 para um caractere que pode ser renderizado por conta própria. O valor será maior que 1 se o caractere fizer parte de um cluster em um script para o qual os cursores não são colocados dentro de um cluster, para indicar o deslocamento para a próxima posição legítima do cursor lógico.

Se a coordenada x estiver antes do início da linha, a função recuperará -1 para piCh e 1 para piTrailing, indicando a borda à direita do caractere inexistente antes da linha. Se a coordenada x estiver após o final da linha, a função recuperará para piCh o primeiro índice além do comprimento da linha e 0 para piTrailing. O valor 0 indica a borda à esquerda do caractere inexistente após a linha.

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

SCRIPT_STRING_ANALYSIS

Uniscribe

Funções Uniscribe