Класс COlePropertiesDialog

Инкапсулирует стандартное диалоговое окно свойств объекта OLE Windows.

class COlePropertiesDialog : public COleDialog

Общие диалоговые окна свойств объектов OLE позволяют легко отображать и изменять свойства элемента документа OLE в соответствии со стандартами Windows. К этим свойствам относятся, среди прочего, сведения о файле, представленном элементом документа, параметрами отображения значка и масштабирования изображений, а также сведения о ссылке элемента (если элемент связан).

Чтобы использовать COlePropertiesDialog объект, сначала создайте объект с помощью конструктора COlePropertiesDialog . После создания диалогового окна вызовите DoModal функцию-член, чтобы отобразить диалоговое окно и разрешить пользователю изменять все свойства элемента. DoModal возвращает значение, выбранное пользователем кнопкой "ОК" (IDOK) или кнопкой "Отмена" (IDCANCEL). Помимо кнопок "ОК" и "Отмена" есть кнопка "Применить". Когда пользователь выбирает "Применить", все изменения, внесенные в свойства элемента документа, применяются к элементу и его изображение автоматически обновляются, но остаются активными.

Элемент данных m_psh — это указатель на PROPSHEETHEADER структуру, и в большинстве случаев доступ к ней не требуется явным образом. Одно из исключений заключается в том, что требуются дополнительные страницы свойств за пределами страниц общего, представления и ссылки. В этом случае можно изменить m_psh член данных, чтобы включить пользовательские страницы перед вызовом DoModal функции-члена.

Дополнительные сведения о диалоговых окнах OLE см. в статье "Диалоговые окна" в OLE.

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Заголовок: afxodlgs.h

Создает объект COlePropertiesDialog.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

pItem
Указатель на элемент документа, к которому обращаются свойства.

nScaleMin
Минимальный процент масштабирования для изображения элемента документа.

nScaleMax
Максимальный процент масштабирования для изображения элемента документа.

pParentWnd
Указатель на родительский или владелец диалогового окна.

Наследуйте общий класс диалогового окна "Свойства объекта OLE" для COlePropertiesDialog реализации масштабирования элементов документа. Любые диалоговые окна, реализованные экземпляром этого класса, не поддерживают масштабирование элемента документа.

По умолчанию в диалоговом окне "Свойства объекта OLE" есть три страницы по умолчанию:

• Общие

  Эта страница содержит системные сведения о файле, представленном выбранным элементом документа. На этой странице пользователь может преобразовать выбранный элемент в другой тип.

• Представления

  Эта страница содержит параметры отображения элемента, изменения значка и изменения масштабирования изображения.

• Ссылка

  Эта страница содержит параметры изменения расположения связанного элемента и обновления связанного элемента. На этой странице пользователь может разорвать ссылку выбранного элемента.

Чтобы добавить страницы за пределами указанных по умолчанию, измените переменную члена m_psh перед выходом конструктора класса-производного COlePropertiesDialogкласса. Это расширенная реализация конструктора COlePropertiesDialog .

Вызовите эту функцию-член, чтобы отобразить диалоговое окно "Общие свойства объекта OLE" Windows и разрешить пользователю просматривать и/или изменять различные свойства элемента документа.

virtual INT_PTR DoModal();

IdOK или IDCANCEL в случае успешного выполнения; в противном случае — 0. IDOK и IDCANCEL — это константы, указывающие, выбран ли пользователь кнопку "ОК" или "Отмена".

Если идентификатор IDCANCEL возвращается, можно вызвать функцию Windows CommDlgExtendedError , чтобы определить, произошла ли ошибка.

Структура типа OLEUIGNRLPROPS, используемая для инициализации страницы "Общие" диалогового окна "Свойства объекта OLE".

OLEUIGNRLPROPS m_gp;

На этой странице показан тип и размер внедрения и разрешен доступ пользователя к диалоговому окне "Преобразование". На этой странице также отображается назначение ссылки, если объект является ссылкой.

Дополнительные сведения о OLEUIGNRLPROPS структуре см. в пакете SDK для Windows.

Структура типа OLEUILINKPROPS, используемая для инициализации страницы ссылки диалогового окна "Свойства объекта OLE".

OLEUILINKPROPS m_lp;

На этой странице показано расположение связанного элемента и позволяет пользователю обновлять или прерывать ссылку на элемент.

Дополнительные сведения о OLEUILINKPROPS структуре см. в пакете SDK для Windows.

Структура типа OLEUIOBJECTPROPS, используемая для инициализации общего диалогового окна свойств объекта OLE.

OLEUIOBJECTPROPS m_op;

Эта структура содержит элементы, используемые для инициализации страниц "Общие", "Ссылка" и "Вид".

Дополнительные сведения см. в структурах OLEUIOBJECTPROPS и OLEUILINKPROPS в пакете SDK для Windows.

Структура типа PROPSHEETHEADER, члены которой хранят характеристики объекта диалогового окна.

PROPSHEETHEADER m_psh;

После создания COlePropertiesDialog объекта можно задать m_psh различные аспекты диалогового окна перед вызовом DoModal функции-члена.

Если изменить m_psh член данных напрямую, вы переопределите любое поведение по умолчанию.

Дополнительные сведения о PROPSHEETHEADER структуре см. в пакете SDK для Windows.

Структура типа OLEUIVIEWPROPS, используемая для инициализации страницы представления диалогового окна "Свойства объекта OLE".

OLEUIVIEWPROPS m_vp;

Эта страница позволяет пользователю переключаться между представлениями содержимого и знаковых представлений объекта и изменять его масштабирование в контейнере. Он также позволяет пользователю получить доступ к диалоговому окне "Значок изменения" при отображении объекта в виде значка.

Дополнительные сведения о OLEUIVIEWPROPS структуре см. в пакете SDK для Windows.

Вызывается платформой, когда значение масштабирования изменилось, и выбран вариант "ОК" или "Применить".

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

pItem
Указатель на элемент документа, к которому обращаются свойства.

nCurrentScale
Числовое значение шкалы диалогового окна.

bRelativeToOrig
Указывает, применяется ли масштабирование к исходному размеру элемента документа.

Ненулевое значение, если обработано; в противном случае — 0.

Реализация по умолчанию не выполняет никаких действий. Чтобы включить элементы управления масштабированием, необходимо переопределить эту функцию.

Пример CIRC MFC
Класс COleDialog
Диаграмма иерархии
Класс COleDialog
Класс CPropertyPage