Função ScriptCPtoX (usp10.h)
Gera o deslocamento x da extremidade esquerda ou da borda superior de uma execução para a borda à esquerda ou à direita de um cluster de caracteres lógicos.
Sintaxe
HRESULT ScriptCPtoX(
[in] int iCP,
[in] BOOL fTrailing,
[in] int cChars,
[in] int cGlyphs,
[in] const WORD *pwLogClust,
[in] const SCRIPT_VISATTR *psva,
[in] const int *piAdvance,
[in] const SCRIPT_ANALYSIS *psa,
[out] int *piX
);
Parâmetros
[in] iCP
Posição do caractere lógico na execução. Esse parâmetro corresponde ao deslocamento de qualquer caractere lógico no cluster.
[in] fTrailing
TRUE para usar a borda à direita do cluster de caracteres lógicos para calcular o deslocamento. Esse parâmetro é definido como FALSE para usar a borda superior do cluster de caracteres lógicos.
[in] cChars
Número de caracteres na execução.
[in] cGlyphs
Número de glifos na execução.
[in] pwLogClust
Ponteiro para os clusters lógicos.
[in] psva
Ponteiro para uma SCRIPT_VISATTR matriz de atributos visuais.
[in] piAdvance
Ponteiro para um valor de larguras avançadas.
[in] psa
Ponteiro para uma estrutura SCRIPT_ANALYSIS . O membro fLogicalOrder especifica o final da execução do qual medir o deslocamento. Se o sinalizador estiver definido, a borda superior da execução será usada. Se o sinalizador não estiver definido, a extremidade esquerda da execução será usada.
[out] piX
Ponteiro para o buffer no qual a função recupera a posição x do cursor.
Retornar valor
Retorna 0 se for bem-sucedido. Essa 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
A borda à esquerda ou à direita do caractere e a borda superior de uma execução dependem da direção do texto na execução.
Para scripts nos quais o cursor é colocado convencionalmente no meio de clusters (por exemplo, árabe e hebraico), a posição x recuperada do carat pode ser uma posição interpolada para qualquer ponto de código na linha.
Para scripts nos quais o cursor é convencionalmente ajustado para os limites dos clusters (por exemplo, tailandês e indiano), a posição x é encaixada na borda solicitada do cluster que contém a posição de caractere lógico indicada pelo iCP.
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 |