Compartilhar via


EM_GETLINE mensagem (Winuser.h)

Copia uma linha de texto de um controle de edição e a coloca em um buffer especificado. Você pode enviar essa mensagem para um controle de edição ou um controle de edição avançada.

Parâmetros

wParam

O índice baseado em zero da linha a ser recuperada de um controle de edição multilinha. Um valor zero especifica a linha mais alta. Esse parâmetro é ignorado por um controle de edição de linha única.

lParam

Um ponteiro para o buffer que recebe uma cópia da linha. Antes de enviar a mensagem, defina a primeira palavra desse buffer como o tamanho, em TCHARs, do buffer. Para texto ANSI, esse é o número de bytes; para texto Unicode, esse é o número de caracteres. O tamanho na primeira palavra é substituído pela linha copiada.

Valor retornado

O valor retornado é o número de TCHARcopiados. O valor retornado será zero se o número de linha especificado pelo parâmetro wParam for maior que o número de linhas no controle de edição.

Comentários

Editar controles: A linha copiada não contém um caractere nulo de terminação.

Controles de edição avançada: Com suporte no Microsoft Rich Edit 1.0 e posterior. A linha copiada não contém um caractere nulo de terminação, a menos que nenhum texto tenha sido copiado. Se nenhum texto tiver sido copiado, a mensagem colocará um caractere nulo no início do buffer. Para obter informações sobre a compatibilidade de versões de edição avançada com as várias versões do sistema, consulte Sobre 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 (inclua Windows.h)

Confira também

Referência

EM_LINELENGTH

Edit_GetLine

Outros recursos

WM_GETTEXT