Soubor JScript
Vlastní průvodce zpřístupňuje skriptovací stroj a vytvoří pro každý projekt soubor JScript s názvem Default.JS. Dále také zahrne Common.JS. Tyto soubory obsahují funkce JScript, které umožňují přístup k objektovým modelům sady Visual Studio a aplikace Visual C++ sloužících k přizpůsobení průvodce. (Pro seznam těchto modelu navštivte Navrhování průvodce.) Do souboru Default.JS projektu průvodce lze přidat vlastní funkce. Chcete-li získat přístup k vlastnostem a metodám v objektu modelu, nebo k prostředí modelu ze souboru JScript, připojte objekt modelu k „wizard.", případně k „dte."
Příklad:
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"))
...
Po kliknutí na tlačítko Dokončit ve Vlastním průvodci, načte průvodce soubor Default.JS ve složce Soubory skriptu v Průzkumníku řešení. Tento soubor JScript vytvoří projekty, vykreslí šablony a po kliknutí na tlačítko Dokončit je přidá do řešení.
Ve výchozím nastavení obsahuje projektový soubor Default.JS následující funkce:
Název funkce |
Popis |
|---|---|
AddConfig |
Přidá konfiguraci projektu. Lze zadat nastavení kompilátoru a propojovacího programu. |
AddFilesToCustomProj |
Po kliknutí na tlačítko Dokončit přidá určené soubory do projektu. |
AddFilters |
Po kliknutí na tlačítko Dokončit přidá určené zdrojové filtry do projektu. |
CreateCustomProject |
Po kliknutí na tlačítko Dokončit vytvoří projekt v zadaném umístění. |
CreateCustomInfFile |
Vytvoří projektový soubor Templates.INF. |
DelFile |
Odstraní zadaný soubor. |
GetTargetName |
Získá název zadaného souboru. |
OnFinish |
Volána průvodcem po kliknutí na tlačítko Dokončit. Vytvoří projekt, přidá soubory a filtry, vykreslí šablony a nastaví konfiguraci. |
PchSettings |
Upraví nastavení předkompilovaných hlaviček. Pro další informace navštivte SetCommonPchSettings v odkazech Common.JS. |
Každý průvodce má jedinečný soubor Default.JS, který obsahuje TODO komentáře, které vám pomohou přizpůsobit soubor.
Visual C++ také obsahuje soubor Common.JS, což je soubor sdíleny všemi průvodci a jenž je součástí projektu průvodce. Funkce v Common.JS lze používat.
Poznámka
Common.JS obsahuje popis každé funkce a její parametry. Pro více informací prostudujte komentáře v Common.JS.
Máte-li funkci, kterou chcete sdílet mezi projekty průvodce, můžete jí přidat do Common.JS. Vytvořte vlastní verzi Common.JS, uložte ji v obecné cestě a nastavte SCRIPT_COMMON_PATH k této cestě v souboru .VSZ.
Poznámka
Průvodce, který je součástí aplikace Visual C++, použije funkce JScript v Common.JS. Jestliže tyto funkce změníte, mohou se průvodci Visual C++ chovat neočekávaně.
Další informace o JScript naleznete v tématu Writing, Compiling, and Debugging JScript Code.
Ladění skriptu
Chcete-li ladit skript v souborech HTML průvodce, je nutné povolit ladění skriptů.
Povolení ladění skriptů
V aplikaci Internet Explorer klikněte na nabídku Nástroje a zvolte Možnosti Internetu.
Klepněte na kartu Upřesnit.
V kategorii Procházení zrušte zaškrtnutí Zakázat ladění skriptů.
To také umožní zobrazení common.JS a default.JS v okně Spuštěné dokumenty po kliknutí na tlačítko Dokončit v průvodci.