Класс CMFCEditBrowseCtrl

Статья
06/10/2015

Класс CMFCEditBrowseCtrl поддерживает элемент управления Обзор, редактируемом текстовом поле, при необходимости содержащую кнопку обзор. Когда пользователь нажимает кнопку обзора, элемент управления выполняет настраиваемого действия или отображает стандартное диалоговое окно, содержащее браузер файла или обозреватель папок.

class CMFCEditBrowseCtrl : public CEdit

Члены

Открытые конструкторы

Имя	Описание
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl	Конструктор по умолчанию.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl	Деструктор.

Открытые методы

Имя	Описание
CMFCEditBrowseCtrl::EnableBrowseButton	Включение или отключение () скрывает кнопку обзор.
CMFCEditBrowseCtrl::EnableFileBrowseButton	Включает кнопку обзора и помещает элемент управления Обзор в режиме просмотра файла.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Включает кнопку обзора и помещает элемент управления Обзор в режиме просмотра папок.
CMFCEditBrowseCtrl::GetMode	Возвращает текущий режим просмотра.
CMFCEditBrowseCtrl::OnAfterUpdate	Вызываемый средой после элемента управления Обзор обновляет с результатом действия просмотра.
CMFCEditBrowseCtrl::OnBrowse	Вызываемый средой после того, как пользователь нажимает кнопку обзор.
CMFCEditBrowseCtrl::OnChangeLayout	Перерисовывает текущий элемент управления.
CMFCEditBrowseCtrl::OnDrawBrowseButton	Вызываемый платформой для рисования кнопку обзор.
CMFCEditBrowseCtrl::OnIllegalFileName	Вызываемый платформой, когда недопустимое имя файла было введено в элемент управления "Поле ввода".
CMFCEditBrowseCtrl::PreTranslateMessage	Преобразует сообщения окна до их посланы к функциям TranslateMessage и DispatchMessage Windows. Синтаксис и дополнительные сведения см. в разделе CWnd::PreTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Задает пользовательский способ для кнопки обзор.

Заметки

Используйте элемент управления Обзор, чтобы выбрать имя файла или папки. При необходимости используйте элемент управления для выполнения настраиваемого действия, как отобразить диалоговое окно. Можно показывать или не указывать кнопку обзора, и можно применять пользовательские метки или образ на кнопке.

Режим просмотра элемента управления Обзор определяет, указывает ли он кнопку обзора и какое действие возникает при нажатии кнопки " нажата. Дополнительные сведения см. в описании метода GetMode.

Класс CMFCEditBrowseCtrl поддерживает следующие режимы.

custom mode
Настраиваемое действие выполняется, когда пользователь нажимает кнопку обзор. Например, можно отобразить конкретного приложения диалоговое окно.
file mode
Диалоговое окно выбора стандартного файла отображается, когда пользователь нажимает кнопку обзор.
folder mode
Стандартное диалоговое окно выбора папки отображается, когда пользователь нажимает кнопку обзор.

Практическое руководство. Укажите элемент управления Обзор

Выполните следующие шаги, чтобы включить элемент управления Обзор в приложении:

Если необходимо реализовать пользовательский режим просмотра, создайте собственный класс, производный от класса CMFCEditBrowseCtrl а затем переопределить метод CMFCEditBrowseCtrl::OnBrowse. В переопределенном методе выполните пользовательское действие просмотра и обновления элемент управления Обзор с результатом.
Внедрение или объект CMFCEditBrowseCtrl или производный объект элемента управления Обзор в объект родительского окна.
При использовании Мастер классов для создания диалогового окна, добавьте элемент управления "Поле ввода" (CEdit) в форму диалогового окна. Кроме того, добавьте переменную для доступа к элементу управления в пользовательском файле заголовка. В файле заголовка, измените тип переменной из CEdit к CMFCEditBrowseCtrl. Элемент управления будет создать автоматически. Если не используется Мастер классов, добавьте переменную CMFCEditBrowseCtrl к файлу заголовка и затем вызовите его метод Create.
При добавлении элемента управления в диалоговое окно Обзор, используйте средство ClassWizard чтобы настроить обмен данными.
Вызовите метод EnableFolderBrowseButton, EnableFileBrowseButton или EnableBrowseButton чтобы установить режим просмотра и отобразить кнопку обзор. Вызовите метод GetMode чтобы получить текущий режим просмотра.
Чтобы обеспечить пользовательский способ для кнопки обзора, вызовите метод SetBrowseButtonImage или переопределите метод OnDrawBrowseButton.
Чтобы удалить кнопку обзора из элемента управления Обзор, вызовите метод EnableBrowseButton с параметром bEnable установлен FALSE.

Иерархия наследования

Пример

В следующем примере демонстрируется использование метода в классе CMFCEditBrowseCtrl : 2 EnableFolderBrowseButton и EnableFileBrowseButton. Данный пример является частью Создать образец элементов управления.

  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();

Требования

заголовок: afxeditbrowsectrl.h

См. также

Ссылки

Диаграмма иерархии

Другие ресурсы

Классы MFC

Поделиться через