Элементы управления ActiveX MFC: страницы свойств
Страницы свойств позволяют пользователю элемента управления ActiveX просматривать и изменять свойства элемента управления ActiveX.Доступ к этим свойствам осуществляется путем вызова диалогового окна свойств элемента управления, которое содержит одно или несколько страниц свойств, предоставляющих настраиваемый графический интерфейс для просмотра и редактирования свойств элемента управления.
Страницы свойств элемента управления ActiveX отображаются в 2 случаях:
Если команда свойств элемента управления (OLEIVERB_PROPERTIES) вызове элемент управления открывает модальное диалоговое окно " свойства, содержащего страницы свойств для элемента управления.
Контейнер может указать собственное безрежимное диалоговое окно, указывающее страницы свойств выбранного элемента.
Диалоговое окно свойства (проиллюстрированное на следующем рисунке) состоит из области для отображения текущей страницы свойств, вкладок для переключения между страницами, свойства и коллекции кнопок, выполняющих распространенные задачи, как закрыть диалоговое окно страницы свойств, отменя все изменения, сделанные либо все изменения немедленно при применении к элементу управления ActiveX.
Диалоговое окно " свойства "
.gif "Диалоговое окно “Свойства” Circ3")
В данной статье описываются разделы, относящиеся к использованию страниц свойств элемента управления ActiveX.К ним относятся:
Реализация страницы свойств по умолчанию для элемента управления ActiveX
Добавление элементов управления на страницу свойств
Настраивать DoDataExchange функция
Дополнительные сведения об использовании страниц свойств элемента управления ActiveX см. в следующих статьях:
Элементы управления ActiveX MFC: Добавить другую страницу пользовательских свойств
Элементы управления ActiveX MFC: С помощью страницы стандартных свойств
Дополнительные сведения об использовании страниц свойств в приложении MFC за исключением элементов управления ActiveX см. в разделе Страницы свойств (MFC).
Реализация страницы свойств по умолчанию
Если используется мастер элементов управления ActiveX, чтобы создать проект элемента управления, то мастер элементов управления ActiveX предоставляет класс страницы свойств по умолчанию для элемента управления, производного от Класс COlePropertyPage.Первоначально эта страница свойств пуста, но можно добавить любой элемент управления диалогового окна или набор элементов управления на него.Поскольку мастер элементов управления ActiveX создает только один по умолчанию для класса страницы свойств, дополнительные классы, производные от страницы свойств (также COlePropertyPage) должны быть созданы с помощью представления классов.Дополнительные сведения об этой процедуре см. в разделе Элементы управления ActiveX MFC: Добавить другую страницу пользовательских свойств.
Реализация страницы свойств (в этом случае по умолчанию) процесс 3 этапа:
Реализация страницы свойств
Добавьте COlePropertyPage- производный класс к проекту элемента управления.Если проект был создан с использованием мастера элементов управления ActiveX (как в этом случае), класс страницы свойств по умолчанию уже существует.
Используйте редактор диалоговых окон для добавления всех элементов управления в шаблон страницы свойств.
Настройка функция COlePropertyPage- производный класс DoDataExchange к меновым стоимостям между элементом управления и страницы свойств элемента управления ActiveX.
Например цели следующие процедуры используют простой элемент управления с именем «образцом (»).Образец была создана с помощью мастера элементов управления ActiveX и содержит только стандартные свойства заголовка.
Добавление элементов управления на страницу свойств
Добавление элементов управления на страницу свойств
С помощью открытого проекта элемента управления, откройте представление ресурсов.
Дважды щелкните значок каталога Диалоговое окно.
Открыть диалоговое окно " IDD_PROPPAGE_SAMPLE .
Мастер элементов управления ActiveX добавляет имя проекта в конец идентификатор диалогового окна в этом случае выборка.
Перетаскивание выбранный элемент из панели элементов на область диалогового окна.
В этом примере заголовок элемента управления текстовой подписи «: элемент управления» поле ввода " с идентификатором и IDC_CAPTION достаточно.
Щелкните Сохранить на панели инструментов, чтобы сохранить внесенные изменения.
Теперь, когда пользовательский интерфейс был изменен, необходимо связать поле ввода " с помощью свойства заголовка.Это делается в следующем разделе, редактирование функция CSamplePropPage::DoDataExchange.
Настраивать DoDataExchange функция
Функция CWnd::DoDataExchange страницы свойств позволяет значениям страницы свойств связи с фактическими значениями свойств в элементе управления.Для установления связи необходимо сопоставить соответствующие поля страницы свойств в соответствующие свойствам элемента управления.
Эти сопоставления реализуются с помощью функции DDP_ страницы свойств.Функции DDP_ работают как функции DDX_, используемые в стандартных диалоговых окнах MFC с одним исключением.В дополнение к ссылке на переменную элемента, функции DDP_ принимают имя свойства элемента управления.Следующее типичная запись в функции DoDataExchange страницы свойств.
DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));
Эта функция связывает переменную участника m_caption страницы свойств с заголовком с помощью функции DDP_TEXT.
После создания управления страницы свойств вставляются необходимо установить связь между элементов управления страницы свойств IDC_CAPTION и фактическим свойством элемента управления, заголовком, с помощью функции DDP_Text, как описано выше.
Страницы свойств (MFC) доступно для других типов элементов управления диалогового окна, как флажков, переключателей и списки.В таблице ниже перечислены полный набор функций DDP_ страницы свойств и их целях:
Функции страницы свойств
Имя функции |
Используйте эту функцию для связывания |
|---|---|
DDP_CBIndex |
Индекс строки, выбранной в поле со списком со свойством элемента управления. |
DDP_CBString |
Выбранная строка в поле со списком со свойством элемента управления.Выбранной строке может начинаться с теми же символов в качестве значения свойства должен совпадать с ней но не полностью. |
DDP_CBStringExact |
Выбранная строка в поле со списком со свойством элемента управления.Выбранная строка и строковое значение свойства должны точно совпадать. |
DDP_Check |
Флажок с свойством элемента управления. |
DDP_LBIndex |
Индекс строки, выбранной в списке с свойством элемента управления. |
DDP_LBString |
Выбранная строка в списке с свойством элемента управления.Выбранной строке может начинаться с теми же символов в качестве значения свойства должен совпадать с ней но не полностью. |
DDP_LBStringExact |
Выбранная строка в списке с свойством элемента управления.Выбранная строка и строковое значение свойства должны точно совпадать. |
DDP_Radio |
Переключатель с свойством элемента управления. |
DDP_Text |
Текст с свойством элемента управления. |