ATL プロパティ ページ ウィザード
このウィザードは、Visual Studio 2019 以降では利用できません。
このウィザードでは、ATL プロジェクトにプロパティ ページを追加できます (または、ATL サポートを含む MFC プロジェクトが使えます)。 ATL プロパティ ページには、1 つまたは複数の COM オブジェクトのプロパティを設定する (またはメソッドを呼び出す) ためのユーザー インターフェイスが用意されています。
解説
Visual Studio 2008 以降、このウィザードによって生成された登録スクリプトでは、その COM コンポーネントが HKEY_LOCAL_MACHINE ではなく HKEY_CURRENT_USER 下に登録されます。 この動作を変更するには、ATL ウィザードの [すべてのユーザーについてコンポーネントを登録] オプションを設定します。
[名前]
プロジェクトに追加するオブジェクト、インターフェイス、およびクラスの名前を指定します。 [短い名前] 以外のすべてのボックスは個別に編集できます。 [短い名前] のテキストを変更すると、このページ内にある他のすべてのボックスの名前に変更が反映されます。 COM セクションで [コクラス] の名前を変更すると、その変更は [種類] と [ProgID] のボックスに反映されます。 名前付けに関するこの動作は、プロパティ ページを開発するときに、すべての名前を識別しやすくするために設計されています。
Note
[コクラス] は属性なしプロジェクトでのみ編集可能です。 プロジェクトが属性付きである場合は、[コクラス] を編集できません。
C++
オブジェクトを実装するために作成される C++ クラスの情報を指定します。
| 任期 | 定義 |
|---|---|
| 短い名前 | オブジェクトの省略名を設定します。 指定する名前によって、クラスと [コクラス] の名前、ファイル (.cpp と .h) の名前、[種類] の名前、[ProgID] が決まります (各フィールドを個別に変更しない限り)。 |
| .h ファイル | 新しいオブジェクトのクラスにヘッダー ファイルの名前を設定します。 既定では、この名前は [短い名前] で指定した名前に基づきます。 選択した場所にファイル名を保存するには、あるいはクラス宣言を既存のファイルに追加するには、省略記号ボタンをクリックします。 既存のファイルを選択した場合、ウィザードで [完了] をクリックするまで、ファイルはウィザードによって選択した場所に保存されません。 ウィザードではファイルは上書きされません。 既存のファイルの名前を選択する場合、[完了] をクリックすると、ウィザードからクラス宣言をファイルのコンテンツに追加するかどうかを指定するように求められます。 ファイルを追加するには、[はい] をクリックします。ウィザードに戻り、別のファイル名を指定するには、[いいえ] をクリックします。 |
| クラス | このオブジェクトを実装するクラスの名前を設定します。 この名前は [短い名前] で指定した名前に基づき、クラス名の一般的なプレフィックスである 'C' が先頭に付きます。 |
| .cpp ファイル | 新しいオブジェクトのクラスに実装ファイルの名前を設定します。 既定では、この名前は [短い名前] で指定した名前に基づきます。 ファイル名を選択した場所に保存するには、省略記号ボタンをクリックします。 ファイルは、ウィザードで [完了] をクリックするまで選択した場所に保存されません。 ウィザードではファイルは上書きされません。 既存のファイルの名前を選択する場合、[完了] をクリックすると、ウィザードからクラスの実装をファイルのコンテンツに追加するかどうかを指定するように求められます。 ファイルを追加するには、[はい] をクリックします。ウィザードに戻り、別のファイル名を指定するには、[いいえ] をクリックします。 |
| 属性付き | オブジェクトで属性を使うかどうかを示します。 属性付き ATL プロジェクトにオブジェクトを追加する場合、このオプションが選択され、変更はできません。つまり、属性のサポートと共に作成されたプロジェクトに追加できるのは、属性付きオブジェクトのみです。 属性付きオブジェクトは、属性を使う ATL プロジェクトにのみ追加できます。 属性をサポートしていない ATL プロジェクトに対してこのオプションを選択した場合、ウィザードによって、プロジェクトに属性のサポートを追加するかどうかを指定するように求められます。 既定では、このオプションを設定した後に追加するすべてのオブジェクトは、属性付きとして指定されます (チェック ボックスが選択されます)。 このボックスをオフにして、属性を使わないオブジェクトを追加することができます。 詳細については、「アプリケーションの設定、ATL プロジェクト ウィザード」と「属性の基本的なしくみ」を参照してください。 |
COM
オブジェクトの COM 機能に関する情報を指定します。
コクラス
オブジェクトでサポートされるインターフェイスの一覧を含むコンポーネント クラスの名前を設定します。
Note
属性を使ってプロジェクトを作成するか、このウィザード ページ上でプロパティ ページで属性を使うことを示す場合、ATL には
coclass属性が含まれていないため、このオプションを変更することはできません。Type
レジストリに表示されるオブジェクトの説明を設定します。
ProgID
オブジェクトの CLSID の代わりにコンテナーで使用できる名前を設定します。
関連項目
オプション、ATL プロパティ ページ ウィザード
文字列、ATL プロパティ ページ ウィザード
例: プロパティ ページの実装