File JScript
Durante la Creazione guidata personalizzata viene effettuato l'accesso a un modulo di gestione di script e viene creato un file Jscript, Default.js, per ciascun progetto. Nella Procedura guidata personalizzata è inoltre incluso il file Common.js. In questi file sono inserite le funzioni JScript che consentono di accedere ai modelli a oggetti di Visual Studio e Visual C++ per personalizzare una procedura guidata. Per l'elenco di questi modelli, vedere Progettazione di una procedura guidata. È possibile aggiungere funzioni personalizzate al file Default.js del progetto della procedura guidata. Per accedere a proprietà e metodi del modello a oggetti della procedura guidata o del modello dell'ambiente da un file Jscript, anteporre rispettivamente"wizard." e "dte." all'elemento modello a oggetti.
Di seguito è riportato un esempio:
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"))
...
Quando si sceglie Fine nella Creazione guidata personalizzata, il file Default.js viene caricato nella cartella File di script in Esplora soluzioni. Con questo file Jscript vengono creati progetti e viene eseguito il rendering dei modelli, che vengono quindi aggiunti alla soluzione quando l'utente fa clic su Fine nella procedura guidata.
Per impostazione predefinita il file Default.js del progetto include le seguenti funzioni:
Nome funzione |
Descrizione |
|---|---|
AddConfig |
Aggiunge le configurazioni del progetto. È possibile fornire le impostazioni del compilatore e del linker. |
AddFilesToCustomProj |
Quando si sceglie Fine, aggiunge al progetto i file specificati. |
AddFilters |
Quando si sceglie Fine, aggiunge al progetto i filtri d'origine specificati. |
CreateCustomProject |
Quando si sceglie Fine, crea il progetto nella posizione specificata. |
CreateCustomInfFile |
Crea il file Templates.inf del progetto. |
DelFile |
Elimina il file specificato. |
GetTargetName |
Ottiene il nome del file specificato. |
OnFinish |
Chiamata nella procedura guidata quando si fa clic su Fine per creare il progetto, aggiunge file e filtri, esegue il rendering dei modelli e imposta la configurazione. |
PchSettings |
Definisce le impostazioni dell'intestazione precompilata. Per ulteriori informazioni, vedere SetCommonPchSettings nel riferimento Common.js. |
A ciascuna procedura guidata è associato un file Default.js univoco che include commenti TODO che consentono di identificare i punti in cui è necessario personalizzare il file.
In Visual C++ è inoltre incluso Common.js, un file condiviso tra tutte le procedure guidate e incluso nel progetto della procedura guidata. È possibile utilizzare le funzioni di Common.js.
Nota
Common.js contiene descrizioni di ogni funzione e dei relativi parametri. Per ulteriori informazioni, vedere i commenti in Common.js.
Se si dispone di funzioni che si desidera condividere tra i progetti delle procedure guidate, è possibile aggiungerle al file Common.js. Creare una versione personalizzata di Common.js e salvarla in un percorso comune, quindi impostare SCRIPT_COMMON_PATH su questo percorso nel file con estensione vsz.
Nota
Le procedure guidate incluse in Visual C++ utilizzano le funzioni JScript in Common.js, la cui modifica può provocare comportamenti imprevisti nelle procedure guidate di Visual C++.
Per ulteriori informazioni su JScript, vedere Scrittura, compilazione e debug di codice JScript.
Debug di script
Per effettuare il debug degli script nei file HTML delle procedure guidate, è necessario attivare tale tipo di debug.
Per attivare il debug di script
In Internet Explorer, scegliere Opzioni Internet dal menu Strumenti.
Fare clic sulla scheda Avanzate.
Nella categoria Esplorazione deselezionare la casella di controllo Disabilita debug degli script.
In questo modo verrà inoltre consentita la visualizzazione di common.js e default.js nella finestra Documenti aperti quando si fa clic sul pulsante Fine della procedura guidata.
Vedere anche
Attività
Creazione di una procedura guidata personalizzata
Riferimenti
creazione guidata personalizzata