Share via

添加 IDL MFC 属性

  • 项目

添加 IDL MFC 属性向导将属性添加到接口定义库 (IDL) 接口，该接口在 Microsoft Framework 类 (MFC) 项目中定义。

若要使用此向导，项目必须是 MFC 项目、ActiveX 项目或支持 MFC 的 ATL 项目。 例如，如果你有 Microsoft ActiveX 控件项目，可以按照以下过程将属性添加到解决方案中的 IDL 接口。

将 IDL MFC 属性添加到接口

  1. 在“视图”菜单上，选择“类视图”。

  2. 在类视图窗格中，右键单击要向其添加属性的接口的名称。

    注意

    也可以将属性添加到调度接口，它嵌套在库节点中（除非该项目已特性化）。

  3. 从快捷菜单中，选择“添加”>“添加属性”。

  4. 在“添加 IDL MFC 属性”向导中，提供用于创建属性的信息。

  5. 选择“确定”以添加属性。

对于 MFC 调度接口：

  • 如果选择“成员变量”作为实现类型，则方法和变量将添加到实现它的类中。
  • 如果选择 Get/Set 方法作为实现类型，则两个方法将添加到实现它的类中。

用户界面元素列表

以下部分介绍了“添加 IDL MFC 属性”向导：

Screenshot of Add IDL MFC Property with two parameters: int i and char c. Property type is OLE_COLOR.

  • 属性名称

    设置属性的名称。

    对于与 ActiveX 控件关联的 MFC 调度接口，可以提供自己的名称，也可以从预定义列表中选择常用属性名称。 如果提供自己的属性名称，则常用实现类型不可用。

    有关列表中常用属性说明的详细信息，请参阅属性。

    接口类型 属性名称选项
    ATL 双重接口、自定义接口和本地自定义接口 提供属性名称。
    MFC 调度接口，MFC ActiveX 控件调度接口 提供属性名称或从列表中选择常用属性。

    如果从列表中选择属性，则相应的值出现在“属性类型”框中。 可以更改此类型，具体取决于实现类型选择。

  • 属性类型

    设置要添加的属性类型。

    对于 MFC 调度接口，请提供自己的类型或从预定义列表中进行选择。 如果提供属性的常用实现，则“属性类型”为常用类型且不可更改。

  • 变量名称

    设置与属性关联的成员变量的名称。

    默认情况下，变量名称为 m_PropertyName。 可以编辑此名称。

    此字段仅对 MFC 调度接口可见，并且仅当在“实现类型”下指定“成员变量”时可见。

  • 通知函数

    如果属性更改，请设置调用的通知函数的名称。

    默认情况下，通知函数的名称为 OnPropertyNameChanged。 可以编辑此名称。

    此字段仅对 MFC 调度接口可见，并且仅当在“实现类型”下指定“成员变量”时可见。

  • Get 函数

    设置函数名称以获取属性。

    默认情况下，Get 函数的名称为 GetPropertyName。 可以编辑此名称。

    如果删除此名称，则函数 GetNotSupported 插入接口调度映射。

    此字段仅对 MFC 调度接口可见，并且仅当在“实现类型”下指定“Get/Set 方法”时可见。

  • 设置函数

    设置函数名称以设置属性。

    默认情况下，Set 函数的名称为 SetPropertyName。 可以编辑此名称。

    如果删除此名称，则函数 SetNotSupported 插入接口调度映射。

    此字段仅对 MFC 调度接口可见，并且仅当在“实现类型”下指定“Get/Set 方法”时可见。

  • 实现类型

    指定如何实现要添加的属性。

    仅适用于 MFC 调度接口。

    实施类型 说明
    常用 指定在“属性名称”中选择的属性的默认实现。 有关详细信息，请参阅常用属性。
    如果指定“常用”，则“属性类型”、“参数类型”和“参数名称”都会变暗。
    成员变量 将属性添加为成员变量。
    可以将自定义属性或大多数常用属性添加为成员变量。
    在变量名称和通知函数下提供默认名称。 可以编辑此名称。
    无法为 Caption、hWnd 或 Text 属性指定成员变量。
    Get/Set 方法 指定该属性默认添加为 GetPropertyName 和 SetPropertyName 函数。 这些名称显示在 Get 函数和 Set 函数下。
    可以更改用于传递 Get 函数值的默认属性类型。
    可为 Get 和 Set 函数指定参数。

  • 默认属性

    将属性设置为接口的默认属性。

    一个接口仅能有一个默认属性。

    指定默认属性后，对于添加到接口的任何其他属性，此复选框均不可用。 仅适用于 MFC 调度接口。

  • Parameters

    显示方法的参数和其类型。

  • +

    添加参数。 在“参数”中，键入参数类型和名称，并选择“确定“。 例如： int x

  • x

    从“参数”列表中移除所选参数。

  • 铅笔图标

    编辑所选参数。

  • id

    设置标识属性的数字 ID。

    此选项不适用于自定义接口的属性。 有关详细信息，请查看 MIDL 参考中的 id。

  • helpcontext

    指定一个上下文 ID，使用户在帮助文件中查看关于此属性的信息。

    有关详细信息，请查看 MIDL 参考中的 helpcontext。

  • helpstring

    指定一个字符串，用于描述该字符串适用的元素。 默认情况下为其 property 属性名称。

    有关详细信息，请查看 MIDL 参考中的 helpstring。

常用属性

如果要将属性添加到 MFC 调度接口，可以从“属性名称”下拉列表中选择以下常用属性之一：

属性名称 说明
Appearance 退回或设置确定控件外观的值。
控件的 Appearance 属性可以包含或省略三维显示效果。 此属性是环境读取/写入属性。
BackColor 返回控件的环境 BackColor 属性，或将其设置为调色板 (RGB) 颜色或预定义的系统颜色。
默认情况下，其值对应于控件容器的前景色。
此属性是环境读取/写入属性。
BorderStyle 返回或设置控件的边框样式。
此属性是读取/写入属性。
Caption 返回或设置控件的 Caption 属性。
标题是窗口的标题。 Caption 未包含“成员变量”实现类型。
Enabled 返回或设置控件的 Enabled 属性。
已启用的控件可响应用户生成的事件。
Font 返回或设置控件的环境字体。
如果控件没有字体，则为 Null。
ForeColor 返回或设置控件的环境 ForeColor 属性。
hWnd 返回或设置控件的 hWnd 属性。
未包含“成员变量”实现类型。
ReadyState 返回或设置控件的 ReadyState 属性。
控件可以取消初始化或进行初始化，也可以是正在加载，或者是交互的或完整的。
有关详细信息，请参阅 Internet SDK 中的 READYSTATE。
Text 返回或设置控件中包含的文本。
未包含“成员变量”实现类型。

另请参阅

添加属性

添加 IDL 属性