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