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 |
|
Confira também
-
Referência
-
Outros recursos