Класс COlePropertiesDialog
Инкапсулирует стандартное диалоговое окно свойств объекта OLE Windows.
Синтаксис
class COlePropertiesDialog : public COleDialog
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | Формирует объект COlePropertiesDialog. |
Открытые методы
| Имя | Описание |
|---|---|
| COlePropertiesDialog::D oModal | Отображает диалоговое окно и позволяет пользователю выбирать. |
| COlePropertiesDialog::OnApplyScale | Вызывается платформой при изменении масштабирования элемента документа. |
Открытые члены данных
| Имя | Описание |
|---|---|
| COlePropertiesDialog::m_gp | Структура, используемая для инициализации COlePropertiesDialog страницы "Общие" объекта. |
| COlePropertiesDialog::m_lp | Структура, используемая для инициализации COlePropertiesDialog страницы "Ссылка" объекта. |
| COlePropertiesDialog::m_op | Структура, используемая для инициализации COlePropertiesDialog объекта. |
| COlePropertiesDialog::m_psh | Структура, используемая для добавления дополнительных страниц настраиваемых свойств. |
| COlePropertiesDialog::m_vp | Структура, используемая для настройки страницы COlePropertiesDialog представления объекта. |
Замечания
Общие диалоговые окна свойств объектов OLE позволяют легко отображать и изменять свойства элемента документа OLE в соответствии со стандартами Windows. К этим свойствам относятся, среди прочего, сведения о файле, представленном элементом документа, параметрами отображения значка и масштабирования изображений, а также сведения о ссылке элемента (если элемент связан).
Чтобы использовать COlePropertiesDialog объект, сначала создайте объект с помощью конструктора COlePropertiesDialog . После создания диалогового окна вызовите DoModal функцию-член, чтобы отобразить диалоговое окно и разрешить пользователю изменять все свойства элемента. DoModal возвращает значение, выбранное пользователем кнопкой "ОК" (IDOK) или кнопкой "Отмена" (IDCANCEL). Помимо кнопок "ОК" и "Отмена" есть кнопка "Применить". Когда пользователь выбирает "Применить", все изменения, внесенные в свойства элемента документа, применяются к элементу и его изображение автоматически обновляются, но остаются активными.
Элемент данных m_psh — это указатель на PROPSHEETHEADER структуру, и в большинстве случаев доступ к ней не требуется явным образом. Одно из исключений заключается в том, что требуются дополнительные страницы свойств за пределами страниц общего, представления и ссылки. В этом случае можно изменить m_psh член данных, чтобы включить пользовательские страницы перед вызовом DoModal функции-члена.
Дополнительные сведения о диалоговых окнах OLE см. в статье "Диалоговые окна" в OLE.
Иерархия наследования
COlePropertiesDialog
Требования
Заголовок: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
Создает объект COlePropertiesDialog.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Параметры
pItem
Указатель на элемент документа, к которому обращаются свойства.
nScaleMin
Минимальный процент масштабирования для изображения элемента документа.
nScaleMax
Максимальный процент масштабирования для изображения элемента документа.
pParentWnd
Указатель на родительский или владелец диалогового окна.
Замечания
Наследуйте общий класс диалогового окна "Свойства объекта OLE" для COlePropertiesDialog реализации масштабирования элементов документа. Любые диалоговые окна, реализованные экземпляром этого класса, не поддерживают масштабирование элемента документа.
По умолчанию в диалоговом окне "Свойства объекта OLE" есть три страницы по умолчанию:
Общие
Эта страница содержит системные сведения о файле, представленном выбранным элементом документа. На этой странице пользователь может преобразовать выбранный элемент в другой тип.
Представления
Эта страница содержит параметры отображения элемента, изменения значка и изменения масштабирования изображения.
Ссылка
Эта страница содержит параметры изменения расположения связанного элемента и обновления связанного элемента. На этой странице пользователь может разорвать ссылку выбранного элемента.
Чтобы добавить страницы за пределами указанных по умолчанию, измените переменную члена m_psh перед выходом конструктора класса-производного COlePropertiesDialogкласса. Это расширенная реализация конструктора COlePropertiesDialog .
COlePropertiesDialog::D oModal
Вызовите эту функцию-член, чтобы отобразить диалоговое окно "Общие свойства объекта OLE" Windows и разрешить пользователю просматривать и/или изменять различные свойства элемента документа.
virtual INT_PTR DoModal();
Возвращаемое значение
IdOK или IDCANCEL в случае успешного выполнения; в противном случае — 0. IDOK и IDCANCEL — это константы, указывающие, выбран ли пользователь кнопку "ОК" или "Отмена".
Если идентификатор IDCANCEL возвращается, можно вызвать функцию Windows CommDlgExtendedError , чтобы определить, произошла ли ошибка.
COlePropertiesDialog::m_gp
Структура типа OLEUIGNRLPROPS, используемая для инициализации страницы "Общие" диалогового окна "Свойства объекта OLE".
OLEUIGNRLPROPS m_gp;
Замечания
На этой странице показан тип и размер внедрения и разрешен доступ пользователя к диалоговому окне "Преобразование". На этой странице также отображается назначение ссылки, если объект является ссылкой.
Дополнительные сведения о OLEUIGNRLPROPS структуре см. в пакете SDK для Windows.
COlePropertiesDialog::m_lp
Структура типа OLEUILINKPROPS, используемая для инициализации страницы ссылки диалогового окна "Свойства объекта OLE".
OLEUILINKPROPS m_lp;
Замечания
На этой странице показано расположение связанного элемента и позволяет пользователю обновлять или прерывать ссылку на элемент.
Дополнительные сведения о OLEUILINKPROPS структуре см. в пакете SDK для Windows.
COlePropertiesDialog::m_op
Структура типа OLEUIOBJECTPROPS, используемая для инициализации общего диалогового окна свойств объекта OLE.
OLEUIOBJECTPROPS m_op;
Замечания
Эта структура содержит элементы, используемые для инициализации страниц "Общие", "Ссылка" и "Вид".
Дополнительные сведения см. в структурах OLEUIOBJECTPROPS и OLEUILINKPROPS в пакете SDK для Windows.
COlePropertiesDialog::m_psh
Структура типа PROPSHEETHEADER, члены которой хранят характеристики объекта диалогового окна.
PROPSHEETHEADER m_psh;
Замечания
После создания COlePropertiesDialog объекта можно задать m_psh различные аспекты диалогового окна перед вызовом DoModal функции-члена.
Если изменить m_psh член данных напрямую, вы переопределите любое поведение по умолчанию.
Дополнительные сведения о PROPSHEETHEADER структуре см. в пакете SDK для Windows.
COlePropertiesDialog::m_vp
Структура типа OLEUIVIEWPROPS, используемая для инициализации страницы представления диалогового окна "Свойства объекта OLE".
OLEUIVIEWPROPS m_vp;
Замечания
Эта страница позволяет пользователю переключаться между представлениями содержимого и знаковых представлений объекта и изменять его масштабирование в контейнере. Он также позволяет пользователю получить доступ к диалоговому окне "Значок изменения" при отображении объекта в виде значка.
Дополнительные сведения о OLEUIVIEWPROPS структуре см. в пакете SDK для Windows.
COlePropertiesDialog::OnApplyScale
Вызывается платформой, когда значение масштабирования изменилось, и выбран вариант "ОК" или "Применить".
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Параметры
pItem
Указатель на элемент документа, к которому обращаются свойства.
nCurrentScale
Числовое значение шкалы диалогового окна.
bRelativeToOrig
Указывает, применяется ли масштабирование к исходному размеру элемента документа.
Возвращаемое значение
Ненулевое значение, если обработано; в противном случае — 0.
Замечания
Реализация по умолчанию не выполняет никаких действий. Чтобы включить элементы управления масштабированием, необходимо переопределить эту функцию.
Примечание.
Перед отображением общего диалогового окна свойств объекта OLE платформа вызывает эту функцию с значением NULL для pItem и a - 1 для nCurrentScale. Это делается, чтобы определить, следует ли включить элементы управления масштабированием.
См. также
Пример CIRC MFC
Класс COleDialog
Диаграмма иерархии
Класс COleDialog
Класс CPropertyPage