Função ScriptCPtoX (usp10.h)

Artigo
03/13/2024

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.

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