通过

添加 IDL 方法

  • 项目

“添加 IDL 方法”向导将方法添加到接口定义库 (IDL) 接口，例如在包含 IDL 文件的 ATL 项目中。 此向导在支持 MFC 的项目中不可用。

此向导与添加方法向导和添加 IDL MFC 方法向导的不同之处在于：

  • “添加方法”向导将方法添加到项目中的接口，并可以更新与接口关联的类。
  • “添加 IDL MFC 方法”向导专门用于支持 MFC 的 MFC 项目、ActiveX 项目或 ATL 项目。

向 IDL 接口添加方法

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

  2. 在“类视图”窗格中，展开项目节点，以显示你要向其添加方法的 IDL 接口（.idl 文件）。

  3. 右键单击接口的名称。

  4. 在快捷菜单上，选择“添加”>“添加方法”。

  5. 在“添加 IDL 方法”向导中，提供用于创建方法的信息。

  6. 选择“确定”以添加方法。

用户界面元素列表

以下部分介绍了用于添加方法的向导接口：

使用向导添加方法的屏幕截图。显示两个参数：[ in ] int i 和 [ in ] float f。返回类型为 HRESULT。选择从类型推断出参数值。

  • 方法名称

    提供该方法的名称。

  • 返回类型

    该方法返回的数据类型。 从接口中定义的方法返回错误代码的标准方法是使用 HRESULT。

    下表描述了可以向其添加方法的不同类型的接口，以及允许的返回类型。 对于双接口和自定义接口，返回类型必须为 HRESULT，向导不允许你更改它。

    接口类型 返回类型
    双重接口 HRESULT。 不可更改。
    自定义接口 HRESULT。 不可更改。
    本地自定义接口 提供自己的返回类型或从下拉列表中选择。
    调度接口 提供自己的返回类型或从下拉列表中选择。

  • 参数

    显示方法的参数、修饰符和类型。

  • +

    添加参数。 在“参数”中，键入参数类型、名称和任何修饰符。 例如，[in] int i，然后选择“确定”。

  • x

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

  • 基于类型推断 in/out 参数值

    根据参数的类型插入 [in] 或 [out] 属性。

  • 将最后一个参数设置为返回值 (retval)

    最后一个参数将被视为方法的返回值。

  • 特性

    MIDL 参考中还介绍了以下属性。

    • id

      设置标识方法的数字 ID。 有关详细信息，请参阅 id。

    • call_as

      指定要映射到此本地方法的远程方法的名称。 有关详细信息，请参阅 call_as。

    • helpcontext

      指定一个上下文 ID，让用户可以在帮助文件中查看此方法的相关信息。 有关详细信息，请参阅 helpcontext。

    • helpstring

      指定一个字符串，用于描述该字符串适用的元素。 有关详细信息，请参阅 helpstring。

  • 附加特性

    • hidden

      指示该项虽然存在，但不应在面向用户的浏览器中显示。 有关详细信息，请参阅 hidden。

    • local

      指定接口或函数不是远程的。 有关详细信息，请参阅 local。

    • restricted

      指定不能任意调用库或模块、接口或调度接口的成员。 有关详细信息，请参阅 restricted。

    • source

      指示 coclass、属性或方法的成员是事件源。 对于 coclass 的成员，此属性意味着调用而不是实现该成员。 有关详细信息，请参阅 source。

请参阅

添加方法向导
添加 IDL MFC 方法向导