Mensagem EM_CHARFROMPOS

Obtém informações sobre o caractere mais próximo de um ponto especificado na área do cliente de 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

Este parâmetro não é usado.

lParam

As coordenadas de um ponto na área do cliente do controle. 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 avançada: um ponteiro para uma estrutura POINTL que contém as coordenadas horizontais e verticais.

Controles de edição: o LOWORD contém a coordenada horizontal. O HIWORD contém a coordenada vertical.

Valor retornado

Controles de edição avançada: o valor retornado especifica o índice de caracteres baseado em zero do caractere mais próximo do ponto especificado. O valor retornado indica o último caractere no controle de edição se o ponto especificado estiver além do último caractere no controle.

Controles de edição: o LOWORD especifica o índice baseado em zero do caractere mais próximo do ponto especificado. Esse índice é relativo ao início do controle, não ao início da linha. Se o ponto especificado for além do último caractere no controle de edição, o valor retornado indica o último caractere no controle. O HIWORD especifica o índice baseado em zero da linha que contém o caractere. Para controles de edição de linha única, esse valor é zero. O índice indica o delimitador de linha se o ponto especificado estiver além do último caractere visível em uma linha.

Comentários

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.

Se um ponto for passado para EM_CHARFROMPOS como lParam e o ponto estiver fora dos limites do controle de edição, o lResult será (65535, 65535).

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_POSFROMCHAR

Outros recursos

MAKELPARAM

POINTL