COleConvertDialog 类

项目
10/18/2023

有关详细信息，请参阅 Windows SDK 中的 OLEUICONVERT 结构。

语法

class COleConvertDialog : public COleDialog

成员

公共构造函数

名称	描述
COleConvertDialog::COleConvertDialog	构造 `COleConvertDialog` 对象。

公共方法

名称	描述
COleConvertDialog::DoConvert	执行对话框中指定的转换。
COleConvertDialog::DoModal	显示 OLE“更改项”对话框。
COleConvertDialog::GetClassID	获取与所选的项关联的 CLSID。
COleConvertDialog::GetDrawAspect	指定是否将项绘制为图标。
COleConvertDialog::GetIconicMetafile	获取与此项的图标形式关联的图元文件的句柄。
COleConvertDialog::GetSelectionType	获取所选选择的类型。

公共数据成员

“属性”	描述
COleConvertDialog::m_cv	控制对话框行为的结构。

注解

注意

应用程序向导生成的容器代码使用此类。

有关特定于 OLE 对话框的详细信息，请参阅文章 OLE 中的对话框。

继承层次结构

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 由 m_cv 结构的 clsidConvertDefault 成员指定的类将在选定“转换为”单选按钮时用作类列表框中的默认选择。
CF_SETACTIVATEDEFAULT - 指定 CLSID 由 m_cv 结构的 clsidActivateDefault 成员指定的类将在选定“激活类型”单选按钮时用作类列表框中的默认选择。
CF_SHOWHELPBUTTON - 指定在调用对话框时，将显示“帮助”按钮。

pClassID
指向要转换或激活的项的 CLSID。如果为 NULL，将使用与 pItem 关联的 CLSID。

pParentWnd
指向对话框对象所属的父窗口对象或所有者窗口对象（CWnd 类型）。如果为 NULL，对话框的父窗口将设置为主应用程序窗口。

备注

要显示对话框，请调用 DoModal 函数。

有关详细信息，请参阅 CLSID 项和 OLEUICONVERT 结构。

COleConvertDialog::DoConvert

从 DoModal 成功返回后，调用此函数，以转换或激活一个 COleClientItem 类型的对象。

BOOL DoConvert(COleClientItem* pItem);

参数

pItem
指向要转换或激活的项。不能为 NULL。

返回值

如果成功，则不为 0；否则为 0。

备注

根据用户在“转换”对话框中选择的信息，对项进行转换或激活。

COleConvertDialog::DoModal

调用此函数以显示 OLE 的“转换”对话框。

virtual INT_PTR DoModal();

返回值

对话框的完成状态。以下值之一：

如果对话框成功显示，为 IDOK。
如果用户取消了对话框，为 IDCANCEL。
如果发生错误，为 IDABORT。如果返回 IDABORT，请调用 COleDialog::GetLastError 成员函数以获取有关所发生错误类型的详细信息。有关可能的错误的列表，请参阅 Windows SDK 中的 OleUIConvert 函数。

备注

如果要通过设置 m_cv 结构的成员来初始化各种对话框控件，应在调用 DoModal 之前但在构造对话框对象之后执行此操作。

如果 DoModal 返回 IDOK，可以调用其他成员函数来检索用户在对话框中输入的设置或信息。

COleConvertDialog::GetClassID

通过调用此函数来获取与用户在“转换”对话框中选择的项关联的 CLSID。

REFCLSID GetClassID() const;

返回值

与在“转换”对话框中选择的项关联的 CLSID。

注解

仅在 DoModal 返回 IDOK 后调用此函数。

有关详细信息，请参阅 Windows SDK 中的 CLSID 项。

COleConvertDialog::GetDrawAspect

调用此函数以确定用户是否选择将所选的项显示为图标。

DVASPECT GetDrawAspect() const;

返回值

呈现对象所需的方法。

DVASPECT_CONTENT - 如果未选中“显示为图标”复选框，返回该方法。
DVASPECT_ICON - 如果选中“显示为图标”复选框，返回该方法。

注解

仅在 DoModal 返回 IDOK 后调用此函数。

有关绘图方面的详细信息，请参阅 Windows SDK 中的 FORMATETC 数据结构。

COleConvertDialog::GetIconicMetafile

调用此函数以获取包含所选项的图像方面内容的图元文件的句柄。

HGLOBAL GetIconicMetafile() const;

返回值

如果在通过选择“确定”关闭对话框时，选定了“显示为图标”复选框，返回包含所选项的图标方面的图元文件的句柄；否则返回 NULL。

COleConvertDialog::GetSelectionType

调用此函数以确定在“转换”对话框中选择的转换类型。

UINT GetSelectionType() const;

返回值

所做的选择的类型。

备注

返回类型值由 COleConvertDialog 类中声明的 Selection 枚举类型指定。

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

这些值的简要说明如下：

COleConvertDialog::noConversion - 如果对话框已取消或用户未选择转换，返回该值。如果 COleConvertDialog::DoModal 返回 IDOK，可能是因为用户选择了与以前选择的图标不同的图标。
COleConvertDialog::convertItem - 如果选择了“转换为”单选按钮，用户选择了要转换为的不同的项并且 DoModal 返回 IDOK，返回该项。
COleConvertDialog::activateAs - 如果选择了“激活类型”单选按钮，用户选择了不同的激活项并且 DoModal 返回 IDOK，返回该项。

COleConvertDialog::m_cv

用于控制“转换”对话框的行为的 OLEUICONVERT 类型的结构。

OLEUICONVERT m_cv;

备注

此结构的成员可以直接修改，也可以通过成员函数修改。