Compartilhar via


Mensagem EM_POSFROMCHAR

Recupera as coordenadas da área do cliente de um caractere especificado em um controle de edição. É possível enviar essa mensagem para um controle de edição ou um controle de edição avançado.

Parâmetros

wParam

Rich Edit 1.0 e 3.0: um ponteiro para uma estrutura POINTL que recebe as coordenadas da área do cliente do caractere. As coordenadas estão em unidades de tela e são relativas ao canto superior esquerdo da área do cliente do controle.

Controles de edição e Rich Edit 2.0: o índice baseado em zero do caractere.

lParam

Rich Edit 1.0 e 3.0: o índice baseado em zero do caractere.

Controles de edição e Rich Edit 2.0: este parâmetro não é usado.

Valor retornado

Rich Edit 1.0 e 3.0: o valor retornado não é usado.

Controles de edição e Rich Edit 2.0: o valor de retorno contém as coordenadas da área do cliente do caractere. O LOWORD contém a coordenada horizontal e o HIWORD contém a coordenada vertical.

Comentários

Uma coordenada retornada pode ser um valor negativo se o caractere especificado não for exibido na área do cliente do controle de edição. As coordenadas são truncadas para valores inteiros.

Se o caractere for um delimitador de linha, as coordenadas retornadas indicarão um ponto logo após o último caractere visível na linha. Se o índice especificado for maior que o índice do último caractere no controle, o controle retornará -1.

Rich Edit 3.0 e posterior: para compatibilidade com versões anteriores, o Microsoft Rich Edit 3.0 oferece suporte à sintaxe usada pelo Microsoft Rich Edit 2.0. Se o Microsoft Rich Edit 3.0 detectar que wParam não é um ponteiro POINTL válido, ele assume que a mensagem foi enviada usando a sintaxe do Microsoft Rich Edit 2.0. Nesse caso, ele usa o valor retornado para retornar as coordenadas.

Edição avançada: com suporte no Microsoft Rich Edit 1.0 e posterior. Para obter informações sobre a compatibilidade das versões de edição avançada com as várias versões do sistema, confira Sobre os Controles de Edição Avançada.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Referência

EM_CHARFROMPOS

Outros recursos

POINTL