Classe de CEdit

Artigo
03/26/2013

Fornece a funcionalidade de um controle de edição do windows.

class CEdit : public CWnd

Membros

Construtores public

Nome	Descrição
CEdit::CEdit	Constrói um objeto de controle de CEdit .

Métodos públicos

Nome	Descrição
CEdit::CanUndo	Determina se uma operação de editions controle pode ser desfeita.
CEdit::CharFromPos	Recupera os índices de linha e de caracteres para o caractere mais próximo a uma posição especificada.
CEdit::Clear	Exclui (limpa) a seleção atual (se houver) no controle de edição.
CEdit::Copy	Copia a seleção atual (se houver) no controle de edição para a área de transferência no formato de CF_TEXT .
CEdit::Create	Cria o controle de edição do windows e anexá-la ao objeto de CEdit .
CEdit::Cut	Exclui (corta) a seleção atual (se houver) no controle e as cópias de edição o texto excluído para a área de transferência no formato de CF_TEXT .
CEdit::EmptyUndoBuffer	Reinicializa (limpa) o sinalizador desfazer de um controle de edição.
CEdit::FmtLines	Define a inclusão de caracteres suave de quebra de linha ou dentro de um controle de edição de várias linhas.
CEdit::GetCueBanner	Recupera o texto que é exibido como a indicação de texto, ou a dica, em um controle de edição quando o controle está vazia e não tem o foco.
CEdit::GetFirstVisibleLine	Determina a linha visível o nível mais alto em um controle de edição.
CEdit::GetHandle	Recupera um identificador para a memória que está atualmente atribuído para um controle de edição de várias linhas.
CEdit::GetHighlight	Obtém os índices de caracteres de início e de fim em um intervalo de texto que é realçado no controle de edição atual.
CEdit::GetLimitText	Obtém a quantidade máxima de texto que este CEdit pode conter.
CEdit::GetLine	Recupera uma linha de texto de um controle de edição.
CEdit::GetLineCount	Retorna o número de linhas em um controle de edição de várias linhas.
CEdit::GetMargins	Obtém as margens esquerda e direita para este CEdit.
CEdit::GetModify	Determina se o conteúdo de um controle de edição foram alterados.
CEdit::GetPasswordChar	Retorna o caractere de senha exibido em um controle de edição quando o usuário inserir texto.
CEdit::GetRect	Obtém o retângulo de formatação de um controle de edição.
CEdit::GetSel	Obtém o primeiro e último as posições de caracteres de seleção atual em um controle de edição.
CEdit::HideBalloonTip	Oculta todo o balão de dica associado ao controle de edição atual.
CEdit::LimitText	Limitar o tamanho do texto que o usuário pode inserir em um controle de edição.
CEdit::LineFromChar	Retorna o número de linha da linha que contém o índice de caractere especificado.
CEdit::LineIndex	Retorna o índice do caractere de uma linha em um controle de edição de várias linhas.
CEdit::LineLength	Recupera o comprimento de uma linha em um controle de edição.
CEdit::LineScroll	Rola o texto de um controle de edição de várias linhas.
CEdit::Paste	Insere os dados da área de transferência no controle de edição na posição atual do cursor.Os dados são inseridos somente se a área de transferência contém dados em um formato de CF_TEXT .
CEdit::PosFromChar	Recupera as coordenadas do canto superior esquerdo de um índice especificado de caracteres.
CEdit::ReplaceSel	Substitui a seleção atual em um controle de edição com o texto especificado.
CEdit::SetCueBanner	Define o texto que é exibido como a indicação de texto, ou a dica, em um controle de edição quando o controle está vazia e não tem o foco.
CEdit::SetHandle	Define o identificador na memória local que será usada por um controle de edição de várias linhas.
CEdit::SetHighlight	Realçar um intervalo de texto que é exibido no controle de edição atual.
CEdit::SetLimitText	Define a quantidade máxima de texto que este CEdit pode conter.
CEdit::SetMargins	Defina as margens esquerda e direita para este CEdit.
CEdit::SetModify	Define ou limpa o sinalizador de alteração para um controle de edição.
CEdit::SetPasswordChar	Define ou remove um caractere de senha exibido em um controle de edição quando o usuário inserir texto.
CEdit::SetReadOnly	Define o estado somente leitura de um controle de edição.
CEdit::SetRect	Define o retângulo de formatação de um controle de edição de várias linhas e atualiza o controle.
CEdit::SetRectNP	Define o retângulo de formatação de um controle de edição de várias linhas sem redesenhar a janela do controle.
CEdit::SetSel	Seleciona um intervalo de caracteres em um controle de edição.
CEdit::SetTabStops	Defina as paradas de tabulação em um controle de edição de várias linhas.
CEdit::ShowBalloonTip	Exibe um balão de dica associado ao controle de edição atual.
CEdit::Undo	Inverte a operação da última de editions controle.

Comentários

Um controle de edição é uma janela filho retangular para que o usuário pode inserir texto.

Você pode criar um controle de edição de um modelo na caixa de diálogo ou diretamente no seu código.Em ambos os casos, primeiro chamar o construtor CEdit para construir o objeto de CEdit em seguida, chamar a função de membro de Criar para criar o controle de edição do windows para e anexá-la ao objeto de CEdit .

A compilação pode ser um processo de uma etapa em uma classe derivada de CEdit.Escreva um construtor para a classe derivada e chamar Criar de dentro do construtor.

CEdit herda a funcionalidade significativa de CWnd.Para definir e recuperar o texto de um objeto de CEdit , use as funções de membro SetWindowText e GetWindowTextde CWnd , que obtém ou define o conteúdo de um controle de edição, mesmo se é um controle de várias linhas.As linhas de texto em um controle de várias linhas são separadas seqüências de caracteres “\r\n”.Também, se um controle de edição de várias linhas é, obter e definir a parte do texto de controle chamando as funções de membro GetLine, SetSel, GetSel, e ReplaceSelde CEdit .

Se você desejar manipular as notificações do windows enviadas por um controle de edição ao seu pai (geralmente uma classe derivada de CDialog), adicionar uma função de membro de entrada e de mensagem- manipulador de mensagem- mapa para a classe pai para cada mensagem.

Cada entrada de mapa mensagem- tem a seguinte forma:

ON_Notificação(id, memberFxn)

onde id especifica a identificação da janela filho do controle de edição que envia a notificação, e são memberFxn o nome da função de membro que você escreveu pai para trate a notificação.

O protótipo de função do pai é o seguinte:

memberFxn**( );de vácuo deafx_msg**

A seguir está uma lista de possíveis entradas de mapa mensagem- e uma descrição dos casos em que poderiam ser enviados ao pai:

ON_EN_CHANGE o usuário tiver efetuado uma ação que pode ter alterado o texto em um controle de edição.Diferentemente de notificação de EN_UPDATE , essa notificação é enviada após o atualizar a exibição.
ON_EN_ERRSPACE o controle de edição não pode alocar memória suficiente para localizar uma solicitação específica.
ON_EN_HSCROLL o usuário clica em um barra de rolagem horizontal de controle edit.A janela pai é notificada antes da tela seja atualizada.
ON_EN_KILLFOCUS o controle de edição perde o foco de entrada.
ON_EN_MAXTEXT inserção atual excedeu o número especificado de caracteres para o controle de edição e foi truncado.Também enviado quando um controle de edição não tem o estilo de ES_AUTOHSCROLL e o número de caracteres a serem inseridos puder exceder a largura do controle de edição.Também enviado quando um controle de edição não tem o estilo de ES_AUTOVSCROLL e o número total de linhas resultante de uma inserção de texto puder exceder a altura do controle de edição.
ON_EN_SETFOCUS enviou quando um controle de edição recebe o foco de entrada.
ON_EN_UPDATE o controle de edição é o ponto de exibir o texto alterado.Enviado após o controle tiver formatado o texto mas antes que seleciona o texto para que o tamanho da janela pode ser alterado, se necessário.
ON_EN_VSCROLL o usuário clica em um barra de rolagem vertical de controle edit.A janela pai é notificada antes da tela seja atualizada.

Se você criar um objeto de CEdit de uma caixa de diálogo, o objeto de CEdit é destruído automaticamente quando o usuário fecha a caixa de diálogo.

Se você criar um objeto de CEdit de um recurso da caixa de diálogo usando o editor de diálogo, o objeto de CEdit é destruído automaticamente quando o usuário fecha a caixa de diálogo.

Se você criar um objeto de CEdit em uma janela, você também precisará destrui-la.Se você criar o objeto de CEdit na pilha, é automaticamente destruída.Se você criar o objeto de CEdit no heap usando a função de new , você deve chamar delete no objeto para destrui-lo quando o usuário termina o controle de edição do windows.Se você atribuir qualquer memória do objeto de CEdit , substitua o destrutor de CEdit para descartar as alocações.

Para alterar determinados estilos em um controle de edição (como) ES_READONLYvocê deve enviar mensagens específicas para o controle em vez de usar ModifyStyle.Consulte Estilos de controle edit em Windows SDK.

Para obter mais informações sobre, consulte: CEdit