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

Класс COleConvertDialog

  • Статья

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

Синтаксис

class COleConvertDialog : public COleDialog

Участники

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

Имя Описание
COleConvertDialog::COleConvertDialog Формирует объект COleConvertDialog.

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

Имя Описание
COleConvertDialog::D oConvert Выполняет преобразование, указанное в диалоговом окне.
COleConvertDialog::D oModal Отображает диалоговое окно "Элемент изменения OLE".
COleConvertDialog::GetClassID Возвращает CLSID, связанный с выбранным элементом.
COleConvertDialog::GetDrawAspect Указывает, следует ли нарисовать элемент в виде значка.
COleConvertDialog::GetIconicMetafile Возвращает дескриптор метафайла, связанного с знаковой формой этого элемента.
COleConvertDialog::GetSelectionType Возвращает выбранный тип выделения.

Открытые члены данных

Имя Описание
COleConvertDialog::m_cv Структура, управляющая поведением диалогового окна.

Замечания

Примечание.

Код контейнера, созданный мастером приложений, использует этот класс.

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

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

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Требования

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

COleConvertDialog::COleConvertDialog

Создает только COleConvertDialog объект.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Параметры

pItem
Указывает на элемент, который необходимо преобразовать или активировать.

dwFlags
Флаг создания, содержащий любое количество следующих значений, объединенных с помощью побитового или оператора:

  • CF_SELECTCONVERTTO Указывает, что переключатель "Преобразовать в" будет выбран изначально при вызове диалогового окна. Это значение по умолчанию.

  • CF_SELECTACTIVATEAS Указывает, что переключатель "Активировать от имени" будет выбран изначально при вызове диалогового окна.

  • CF_SETCONVERTDEFAULT Указывает, что класс, clSID которого указан clsidConvertDefault элементом m_cv структуры, будет использоваться в качестве выбора по умолчанию в списке классов при выборе переключателя "Преобразовать в".

  • CF_SETACTIVATEDEFAULT Указывает, что класс, clSID которого указан clsidActivateDefault элементом m_cv структуры, будет использоваться в качестве выбора по умолчанию в списке классов при выборе переключателя "Активировать как".

  • CF_SHOWHELPBUTTON Указывает, что кнопка справки будет отображаться при вызове диалогового окна.

pClassID
Указывает на CLSID элемента, который необходимо преобразовать или активировать. Если значение NULL, будет использоваться CLSID, связанное с pItem .

pParentWnd
Указывает на родительский или владелец объекта окна (типа CWnd), к которому принадлежит объект диалогового окна. Если значение NULL, родительское окно диалогового окна устанавливается в главное окно приложения.

Замечания

Чтобы отобразить диалоговое окно, вызовите функцию DoModal .

Дополнительные сведения см. в разделе CLSID Key и структура OLEUICONVERT .

COleConvertDialog::D oConvert

Вызовите эту функцию после успешного возвращения из DoModal, чтобы преобразовать или активировать объект типа COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Параметры

pItem
Указывает на элемент, который необходимо преобразовать или активировать. Не может быть NULL.

Возвращаемое значение

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

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

COleConvertDialog::D oModal

Вызовите эту функцию, чтобы отобразить диалоговое окно преобразования OLE.

virtual INT_PTR DoModal();

Возвращаемое значение

Состояние завершения диалогового окна. Одно из следующих значений:

  • Идентификатор IDOK, если диалоговое окно было успешно отображено.

  • IdCANCEL, если пользователь отменил диалоговое окно.

  • IDABORT, если произошла ошибка. Если возвращается IDABORT, вызовите функцию члена COleDialog::GetLastError , чтобы получить дополнительные сведения о типе ошибки, которая произошла. Список возможных ошибок см . в функции OleUIConvert в пакете SDK для Windows.

Замечания

Если вы хотите инициализировать различные элементы управления диалоговым окном, задав элементы структуры m_cv , это необходимо сделать перед вызовом DoModal, но после создания объекта диалогового окна.

Если DoModal возвращает идентификатор IDOK, можно вызвать другие функции-члены, чтобы получить параметры или сведения, входные пользователем в диалоговое окно.

COleConvertDialog::GetClassID

Вызовите эту функцию, чтобы получить CLSID, связанный с элементом, выбранным пользователем в диалоговом окне "Преобразование".

REFCLSID GetClassID() const;

Возвращаемое значение

CLSID, связанный с элементом, выбранным в диалоговом окне "Преобразование".

Замечания

Вызовите эту функцию только после возврата идентификатора DoModal .

Дополнительные сведения см. в разделе CLSID Key in the Windows SDK.

COleConvertDialog::GetDrawAspect

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

DVASPECT GetDrawAspect() const;

Возвращаемое значение

Метод, необходимый для отрисовки объекта.

  • DVASPECT_CONTENT возвращается, если флажок значка отображения как не установлен.

  • DVASPECT_ICON возвращается, если установлен флажок "Значок отображения как".

Замечания

Вызовите эту функцию только после возврата идентификатора DoModal .

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

COleConvertDialog::GetIconicMetafile

Вызовите эту функцию, чтобы получить дескриптор метафайла, содержащего знаковый аспект выбранного элемента.

HGLOBAL GetIconicMetafile() const;

Возвращаемое значение

Дескриптор метафайла, содержащего знаковый аспект выбранного элемента, если флажок "Значок отображения как" установлен при закрытии диалогового окна, нажав кнопку "ОК"; в противном случае ЗНАЧЕНИЕ NULL.

COleConvertDialog::GetSelectionType

Вызовите эту функцию, чтобы определить тип преобразования, выбранного в диалоговом окне "Преобразование".

UINT GetSelectionType() const;

Возвращаемое значение

Тип выделенного элемента.

Замечания

Значения возвращаемого COleConvertDialog типа задаются типом Selection перечисления, объявленным в классе.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Краткое описание следующих значений:

  • COleConvertDialog::noConversion Возвращается, если диалоговое окно было отменено или пользователь не выбрал преобразование. При COleConvertDialog::DoModal возврате ИДЕНТИФИКАТОРА возможно, что пользователь выбрал другой значок, отличный от выбранного ранее.

  • COleConvertDialog::convertItem Возвращается, если установлен переключатель "Преобразовать в", пользователь выбрал другой элемент для преобразования и DoModal вернул идентификатор.

  • COleConvertDialog::activateAs Возвращается, если установлен переключатель "Активировать как", пользователь выбрал другой элемент для активации и DoModal вернул идентификатор.

COleConvertDialog::m_cv

Структура типа OLEUICONVERT, используемая для управления поведением диалогового окна "Преобразование".

OLEUICONVERT m_cv;

Замечания

Элементы этой структуры можно изменять напрямую или через функции-члены.

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

См. также

Класс COleDialog
Диаграмма иерархии
Класс COleDialog