JScript ファイル
カスタム ウィザードはスクリプト エンジンにアクセスし、プロジェクトごとに Default.js という JScript ファイルを作成します。また、Common.js もインクルードされます。これらのファイルには JScript 関数が含まれています。JScript 関数を使用すると、Visual Studio や Visual C++ のオブジェクト モデルにアクセスして、ウィザードをカスタマイズできます。これらのオブジェクト モデルの一覧については、「ウィザードのデザイン」を参照してください。ウィザード プロジェクトの Default.js ファイルには、独自の関数を追加できます。JScript ファイルからウィザード オブジェクト モデルや環境モデルのプロパティとメソッドにアクセスするには、オブジェクト モデル アイテムの前にそれぞれ "wizard." および "dte." を付けます。
次に例を示します。
function CreateCustomProject(strProjectName, strProjectPath)
{
try
{
var strProjTemplatePath = wizard.FindSymbol('PROJECT_TEMPLATE_PATH');
var strProjTemplate = '';
strProjTemplate = strProjTemplatePath + '\\default.vcproj';
var Solution = dte.Solution;
var strSolutionName = "";
if (wizard.FindSymbol("CLOSE_SOLUTION"))
...
カスタム ウィザードの [完了] をクリックすると、ウィザードは、ソリューション エクスプローラーの [スクリプト ファイル] フォルダーにある Default.js ファイルを読み込みます。ユーザーがウィザードの [完了] をクリックすると、この JScript ファイルがプロジェクトを作成し、テンプレートをレンダリングして、ソリューションに追加します。
既定では、プロジェクトの Default.js ファイルには次の関数が含まれています。
関数名 |
Description |
|---|---|
AddConfig |
プロジェクトの構成を追加します。コンパイラとリンカーの設定を指定できます。 |
AddFilesToCustomProj |
ユーザーが [完了] をクリックしたときに、指定されたファイルをプロジェクトに追加します。 |
AddFilters |
ユーザーが [完了] をクリックしたときに、指定されたソース フィルターをプロジェクトに追加します。 |
CreateCustomProject |
ユーザーが [完了] をクリックしたときに、指定された場所にプロジェクトを作成します。 |
CreateCustomInfFile |
プロジェクトの Templates.inf ファイルを作成します。 |
DelFile |
指定されたファイルを削除します。 |
GetTargetName |
指定されたファイルの名前を取得します。 |
OnFinish |
ユーザーが [完了] をクリックしたときにウィザードによって呼び出され、プロジェクトを作成し、ファイルとフィルターを追加し、テンプレートをレンダリングし、構成を設定します。 |
PchSettings |
プリコンパイル済みヘッダーを設定します。詳細については、「JScript ファイル」の「SetCommonPchSettings」を参照してください。 |
各ウィザードには固有の Default.js ファイルがあります。このファイルには TODO コメントが含まれており、ファイルをカスタマイズする必要がある箇所を識別するために役立ちます。
Visual C++ には Common.js もあります。このファイルはすべてのウィザードで共有されるファイルであり、作成するウィザード プロジェクトにもインクルードされます。Common.js の関数を使用できます。
[!メモ]
Common.js には、各関数とそのパラメーターの説明が含まれています。詳細については、Common.js のコメントを参照してください。
複数のウィザード プロジェクトで共有する関数がある場合は、その関数を Common.js に追加できます。独自の Common.js を作成して共通パスに保存し、.vsz ファイルで SCRIPT_COMMON_PATH をこの共通パスに設定します。
[!メモ]
Visual C++ に含まれているウィザードでは Common.js の JScript 関数を使用します。これらの関数を変更すると、Visual C++ のウィザードが予測しない動作をする可能性があります。
JScript の詳細については、「Writing, Compiling, and Debugging JScript Code」を参照してください。
スクリプトのデバッグ
ウィザードの html ファイルのスクリプトをデバッグするには、スクリプトのデバッグを有効にする必要があります。
スクリプトのデバッグを有効にするには
Internet Explorer で、[ツール] メニューの [インターネット オプション] を選択します。
[詳細設定] タブをクリックします。
[ブラウズ] の下の [スクリプトのデバッグを使用しない] チェック ボックスをオフにします。
これで、ウィザードの [完了] をクリックすると、common.js と default.js が [実行中のドキュメント] ウィンドウに表示されます。