Compartilhar via


EM_GETHANDLE mensagem

Obtém um identificador da memória alocada atualmente para o texto de um controle de edição de várias linhas.

Parâmetros

wParam

Não usado; deve ser zero.

lParam

Não usado; deve ser zero.

Valor retornado

O valor retornado é um identificador de memória que identifica o buffer que contém o conteúdo do controle de edição. Se ocorrer um erro, como enviar a mensagem para um controle de edição de linha única, o valor retornado será zero.

Comentários

Se a função for bem-sucedida, o aplicativo poderá acessar o conteúdo do controle de edição convertendo o valor retornado para HLOCAL e passando-o para LocalLock. LocalLock retorna um ponteiro para um buffer que é uma matriz terminada em nulo de CHARs ou WCHARs, dependendo se uma função ANSI ou Unicode criou o controle. Por exemplo, se CreateWindowExA tiver sido usado, o buffer será uma matriz de CHARs, mas se CreateWindowExW tiver sido usado, o buffer será uma matriz de WCHARs. O aplicativo pode não alterar o conteúdo do buffer. Para desbloquear o buffer, o aplicativo chama LocalUnlock antes de permitir que o controle de edição receba novas mensagens.

Observação

Para Comctl32.dll versão 6, o buffer sempre contém uma matriz de WCHARs, independentemente de uma função ANSI ou Unicode ter criado o controle de edição. Para obter mais informações sobre versões de DLL, confira Versões de controle comuns.

Se o aplicativo não puder cumprir as restrições impostas pelo EM_GETHANDLE, use as funções GetWindowTextLength e GetWindowText para copiar o conteúdo do controle de edição em um buffer fornecido pelo aplicativo.

Edição avançada: Não há suporte para a mensagem EM_GETHANDLE . Os controles de edição avançada não armazenam texto como uma matriz simples de caracteres.

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_SETHANDLE

Outros recursos

Getwindowtext

GetWindowTextLength

LocalLock

LocalUnlock