Classe CMFCEditBrowseCtrl

Artigo
06/10/2015

A classe de CMFCEditBrowseCtrl oferece suporte a edição ao controle, que é um caixa de texto editável que contém opcionalmente um botão procurar. Quando o usuário clica no botão procurar, o controle executa uma ação personalizada ou exibe uma caixa de diálogo padrão que contém um navegador de arquivo ou um navegador da pasta.

class CMFCEditBrowseCtrl : public CEdit

Membros

Construtores public

Nome	Descrição
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl	Construtor padrão.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl	Destruidor.

Métodos públicos

Nome	Descrição
CMFCEditBrowseCtrl::EnableBrowseButton	Habilita ou desabilita (oculta) o botão procurar.
CMFCEditBrowseCtrl::EnableFileBrowseButton	Habilita o botão procurar e coloca a edição para o controle no modo procurar arquivo.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Habilita o botão procurar e coloca a edição para o controle no modo procurar pasta.
CMFCEditBrowseCtrl::GetMode	Retorna a atual o modo procurar.
CMFCEditBrowseCtrl::OnAfterUpdate	Chamado pela estrutura após a edição ao controle é atualizado com o resultado de uma ação procurar.
CMFCEditBrowseCtrl::OnBrowse	Chamado pela estrutura após o usuário clica no botão procurar.
CMFCEditBrowseCtrl::OnChangeLayout	Redesenho de edição a atual para o controle.
CMFCEditBrowseCtrl::OnDrawBrowseButton	Chamado pela estrutura para desenhar o botão procurar.
CMFCEditBrowseCtrl::OnIllegalFileName	Chamado pela estrutura quando um nome de arquivo inválido foi digitado no controle de edição.
CMFCEditBrowseCtrl::PreTranslateMessage	Converte mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage . Para a sintaxe e mais informações, consulte CWnd::PreTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Define uma imagem personalizado para o botão procurar.

Comentários

Use uma edição para o controle para selecionar um arquivo ou nome da pasta. Opcionalmente, use o controle para executar uma ação personalizada como exibir uma caixa de diálogo. Você pode exibir ou para exibir o botão procurar, e você pode aplicar um rótulo ou uma imagem personalizada no botão.

O modo procurar de edição ao controle determina se exibe um botão procurar e ação que ocorre quando o botão é clicado. Para obter mais informações, consulte o método de GetMode .

A classe de CMFCEditBrowseCtrl oferece suporte aos seguintes modos.

custom mode
Uma ação personalizada é executada quando o usuário clica no botão procurar. Por exemplo, você pode exibir uma caixa de diálogo específicas do aplicativo.
file mode
Uma caixa de diálogo de seleção de arquivo padrão é exibida quando o usuário clica no botão procurar.
folder mode
Uma caixa de diálogo padrão de seleção da pasta é exibida quando o usuário clica no botão procurar.

Como Fazer: Especificar uma edição para o controle

Execute as seguintes etapas para inserir uma edição para o controle no seu aplicativo:

Se você deseja implementar um personalizado o modo procurar, sua própria classe derivada da classe de CMFCEditBrowseCtrl e substituir o método de CMFCEditBrowseCtrl::OnBrowse . Em o método substituído, um personalizado para executar a ação e atualizar a edição para o controle com o resultado.
Inserir ou objeto de CMFCEditBrowseCtrl ou a edição derivado procurar o objeto do controle no objeto pai da janela.
Se você usar Assistente de classe para criar uma caixa de diálogo, adicione um controle de edição (CEdit) para o formulário da caixa de diálogo. Além de isso, adicione uma variável para acessar o controle no arquivo do cabeçalho. Em o arquivo de cabeçalho, altere o tipo da variável de CEdit a CMFCEditBrowseCtrl. A edição ao controle será criada automaticamente. Se você não usar Assistente de classe, adicione uma variável de CMFCEditBrowseCtrl ao seu arquivo de cabeçalho e então chame o método de Create .
Se você adicionar uma edição procurar o controle para uma caixa de diálogo, use a ferramenta de ClassWizard para configurar troca de dados.
Chame o método de EnableFolderBrowseButton, de EnableFileBrowseButton, ou de EnableBrowseButton para definir o modo procurar e para exibir o botão procurar. Chame o método de GetMode para obter a atual o modo procurar.
Para fornecer uma imagem personalizado para o botão procurar, chame o método de SetBrowseButtonImage ou substituir o método de OnDrawBrowseButton .
Para remover o botão procurar de edição procurar o controle, chama o método de EnableBrowseButton com o parâmetro de bEnable definido como FALSE.

Hierarquia de herança

Exemplo

O exemplo seguinte demonstra como usar dois métodos na classe de CMFCEditBrowseCtrl : EnableFolderBrowseButton e EnableFileBrowseButton. Este exemplo é parte de novo exemplo de controles.

  CMFCEditBrowseCtrl m_wndFolderEdit;
    CMFCEditBrowseCtrl m_wndFileEdit;


...


    // enable the browse button and put the control in file browse mode
    m_wndFolderEdit.EnableFolderBrowseButton();
    // enable the browse button and put the control in the folder browse mode
    m_wndFileEdit.EnableFileBrowseButton();

Requisitos

Cabeçalho: afxeditbrowsectrl.h

Consulte também

Referência

Gráfico da hierarquia

Outros recursos

Classes MFC

Compartilhar via