メソッド追加ウィザード
更新 : 2007 年 11 月
このウィザードを使用して、インターフェイスにメソッドを追加します。メソッドを追加するプロジェクトの種類またはインターフェイスの種類に応じて、ウィザードにはさまざまなオプションが表示されます。
名前
[戻り値の型]
メソッドから戻るデータ型です。HRESULT は、エラーを返すための標準的な方法を提供するため、すべてのインターフェイスの種類でこの値が推奨値です。インターフェイスの種類
説明
デュアル インターフェイス
HRESULT。変更できません。
カスタム インターフェイス
HRESULT。変更できません。
ローカル カスタム インターフェイス
戻り値の型を指定するか、一覧から選択します。
ディスパッチ インターフェイス
戻り値の型を指定するか、一覧から選択します。
MFC ActiveX コントロール ディスパッチ インターフェイス
ストック メソッドを実装する場合、戻り値の型は適切な値に設定され、変更できません。[メソッド名] ボックスの一覧からメソッドを選択した場合は、[メソッドの型] の [カスタム] をクリックして戻り値の型を一覧から選択します。
[メソッド名]
メソッドの名前を設定します。インターフェイスの種類
説明
ATL デュアル インターフェイス、カスタム インターフェイス、およびローカル カスタム インターフェイス
メソッド名を指定します。
MFC ディスパッチ インターフェイス
メソッド名を指定するか、表示されたメソッド名の一覧から選択します。一覧から名前を選択した場合は、[戻り値の型] ボックスに適切な値が表示されます。この値は変更できません。
MFC ActiveX コントロール ディスパッチ インターフェイス
メソッド名を指定するか、DoClick と Refresh のいずれかのストック メソッドを選択します。詳細については、「MFC ActiveX コントロール : ストック メソッドの追加」を参照してください。
[メソッドの型]
MFC ActiveX コントロールでだけ有効です。一覧からメソッドを選択せずに、[メソッド名] ボックスでメソッド名を指定した場合、このボックスは無効です。[メソッド名] ボックスからメソッドを選択した場合は、ストック実装またはカスタム実装のいずれかを選択します。
メソッドの型
説明
ストック
既定値です。[メソッド名] ボックスで選択したメソッドのストック実装が挿入されます。[ストック] を選択した場合、[戻り値の型] は変更できません。
カスタム
[メソッド名] ボックスで選択したメソッドのスタブ実装が挿入されます。戻り値の型を設定することも、[戻り値の型] ボックスから選択することもできます。
[内部名]
MFC ディスパッチ インターフェイスに追加されたカスタム メソッドでのみ有効です。ディスパッチ マップ、ヘッダー ファイル (.h)、実装ファイル (.cpp) で使用される名前を設定します。既定では、[メソッド名] と同じ名前になります。MFC ディスパッチ インターフェイスで作業している場合や MFC ActiveX コントロール ディスパッチ インターフェイスにカスタム メソッドを追加している場合は、メソッド名を変更できます。インターフェイスの種類
説明
ATL デュアル インターフェイス、カスタム インターフェイス、およびローカル カスタム インターフェイス
使用できません。
MFC ディスパッチ インターフェイス
既定ではメソッド名になります。この内部名は編集できます。
MFC ActiveX コントロール ディスパッチ インターフェイス
内部名はカスタム メソッドでのみ設定できます。ストック メソッドでは内部名は使用しません。
[パラメータの属性]
[パラメータ名] で指定されたパラメータの追加の属性を設定します。パラメータの属性
説明
使用できる組み合わせ
in
呼び出し元のプロシージャから呼び出し先のプロシージャにパラメータが渡されることを示します。
in のみ
in および out
out
呼び出し先のプロシージャから呼び出し元のプロシージャに (サーバーからクライアントに) ポインタ パラメータが返されることを示します。
out のみ
in および out
out および retval
retval
メンバの戻り値をパラメータが受け取ることを示します。
retval および out
[パラメータの型]
パラメータのデータ型を設定します。一覧から型を選択します。[パラメータ名]
メソッドを通じて渡すパラメータの名前を設定します。パラメータ名を入力したら、[追加] をクリックして、メソッドを通じて渡されるパラメータの一覧に追加する必要があります。パラメータ名を指定しない場合、パラメータのすべての属性 (ATL のみ) と [パラメータの型] の選択項目がウィザードで無視されます。[追加] をクリックすると、入力したパラメータ名が [パラメータの一覧] に表示されます。
メモ パラメータ名を指定し、[追加] をクリックする前に [完了] をクリックした場合、パラメータはメソッドに追加されません。メソッドを見つけて、パラメータを手動で挿入する必要があります。
[追加]
[パラメータ名] で指定したパラメータおよびその型と属性を [パラメータの一覧] に追加します。パラメータを一覧に追加するには [追加] をクリックする必要があります。[削除]
[パラメータの一覧] で選択したパラメータを一覧から削除します。[パラメータの一覧]
メソッドに現在追加されているすべてのパラメータ、およびその修飾子と型を表示します。パラメータを追加すると、ウィザードは [パラメータの一覧] を更新して、各パラメータおよびその修飾子と型を再表示します。