Compartilhar via


CEdit::GetHandle

Chamar essa função para recuperar um identificador para a memória alocada atualmente para um controle de edição de várias linhas.

HLOCAL GetHandle( ) const;

Valor de retorno

Um identificador de memória local que identifica o buffer que contém o conteúdo do controle de edição. Se ocorrer um erro, como enviar a mensagem a um controle de edição de linha única, o valor de retorno é 0.

Comentários

O identificador é um identificador de memória local e pode ser usado por algumas das funções de memória do windows de Local que recebem um identificador de memória local como um parâmetro.

GetHandle é processado por controles de edição de várias linhas.

GetHandle chamada para um controle de edição de várias linhas em uma caixa de diálogo somente se a caixa de diálogo foi criada com o conjunto de sinalizador de estilo de DS_LOCALEDIT . Se o estilo de DS_LOCALEDIT não é definido, você ainda receber um valor de retorno diferente de zero, mas você não poderá usar o valor retornado.

Dica

GetHandle não funcionará com Windows 95 /98.Se você chamar GetHandle no Windows 95, retornará NULO/98.GetHandle funcionará como documentado em, Windows NT 3,51 e versões posteriores.

Para obter mais informações, consulte EM_GETHANDLE em Windows SDK.

Exemplo

HLOCAL h = m_myEdit.GetHandle();
LPCTSTR lpszText = (LPCTSTR) ::LocalLock(h);

// Dump the text of the edit control.
AFXDUMP(lpszText);

::LocalUnlock(h);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CEdit

Gráfico da hierarquia

CEdit::SetHandle