次の方法で共有

IDL メソッドを追加する

  • [アーティクル]

[IDL メソッドの追加] ウィザードでは、IDL ファイルを含む ATL プロジェクトなど、インターフェイス定義ライブラリ (IDL) インターフェイスにメソッドを追加することができます。 このウィザードは、MFC をサポートするプロジェクトでは使用できません。

このウィザードは、次の点で、[メソッドの追加] ウィザードおよび [IDL MFC メソッドの追加] ウィザードとは異なります。

  • [メソッドの追加] ウィザードを使用すると、プロジェクト内のインターフェイスにメソッドを追加し、そのインターフェイスに関連付けられているクラスを更新することができます。
  • [IDL MFC メソッドの追加] ウィザードは、MFC、ActiveX、または MFC をサポートする ATL プロジェクトに固有のものです。

IDL インターフェイスにメソッドを追加する

  1. [表示] メニューの [クラス ビュー] を選択します。

  2. [クラス ビュー] ペインでプロジェクト ノードを展開し、メソッドを追加したい IDL インターフェイス (.idl ファイル) を表示します。

  3. インターフェイス名を右クリックします。

  4. ショートカット メニューで、[追加]>[メソッドの追加] を選択します。

  5. [IDL メソッドの追加] ウィザードで、メソッドを作成するための情報を指定します。

  6. [OK] を選択して、メソッドを追加します。

ユーザー インターフェイス要素の一覧

次のセクションでは、メソッドの追加に使用するウィザード インターフェイスについて説明します。

ウィザードを使ってメソッドを追加するスクリーンショット。[ in ] int i と [ in ] float f という 2 つのパラメーターが示されています。戻り値の型は HRESULT です。[型から in および out パラメーター値を推測する] が選択されています。

  • メソッド名

    メソッドの名前を指定します。

  • 戻り値の型

    メソッドによって返されるデータ型。 インターフェイスで定義されているメソッドからエラー コードを返す標準的な方法は、HRESULT を使用することです。

    次の表では、メソッドを追加できる各種のインターフェイスについて、または許可される戻り値の型について説明します。 デュアルおよびカスタム インターフェイスの場合、戻り値の型を HRESULT とする必要があります。これは、ウィザードで変更することはできません。

    インターフェイスの種類 の戻り値の型 :
    デュアル インターフェイス HRESULT= 変更できません。
    カスタム インターフェイス HRESULT= 変更できません。
    ローカル カスタム インターフェイス 独自の戻り値の型を指定するか、ドロップダウン リストから選択します。
    Dispinterface 独自の戻り値の型を指定するか、ドロップダウン リストから選択します。

  • パラメーター

    メソッドのパラメーター、修飾子、および型を表示します。

  • +

    パラメーターを追加します。 [パラメーター] に、パラメーターの型、名前、および修飾子を入力します。 たとえば、[in] int i です。[OK] を選択します。

  • 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 メソッドの追加] ウィザード