.Soubor Vsz (řízení projektu)
Počáteční bod každého průvodce je soubor .VSZ. Soubor .VSZ je textový soubor, který určuje volaného průvodce a informace předávané průvodci. Soubor obsahuje dvouřádkovou hlavičku následovanou různými nepovinnými parametry předávanými průvodci. Seznam nepovinných parametrů naleznete v tématu Předdefinované vlastní symboly průvodce.
Následující ukázka představuje hlavičku v souboru .VSZ:
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.10.0
Param="WIZARD_NAME = My AppWizard"
První řádek hlavičky určuje číslo verze formátu souboru šablony. Toto číslo lze zadat jako 6.0, 7.0 nebo 7.1. Žádná další čísla nejsou platná, a při jejich použití je výsledkem chyba "Neplatný formát".
Druhý řádek nastavuje proměnnou Wizard na identifikátor průvodce ProgID, který je spoluvytvářen pomocí sady Visual Studio. Identifikátor ProgID je řetězcová reprezentace identifikátoru CLSID, jako například VsWizard.VsWizardEngine.10.0.
Pokud má průvodce uživatelské rozhraní, identifikátor ProgID automaticky nastaví průvodce k implementaci IVCWizCtlUI. Ve výchozím nastavení jsou metody tohoto rozhraní použity v souborech .HTM projektu. Chování průvodce lze změnit pomocí metod tohoto rozhraní v souborech .HTM. Pro další informace o významu coclass pro IVCWizCtlUI naleznete v tématu VCWizCtl.
Následující dva řádky představují volitelný seznam parametrů, které umožňuj souboru .VSZ předat další parametry pro průvodce. Každá hodnota je předán jako element řetězce v poli proměnných v řídící metodě průvodce Execute. Ve výchozím nastavení průvodce s uživatelským rozhraním vytvoří následující výchozí parametry:
Param="START_PATH = <path to the wizard>" Param="HTML_PATH = <path to the wizard's HTML file>" Param="TEMPLATES_PATH = <path to the wizard's template file>" Param="SCRIPT_PATH = <path to the wizard's script files>" Param="IMAGES_PATH = <path to the wizard's images>"Pokud průvodce nemá uživatelské rozhraní, nemá parametr IMAGES_PATH a místo něj obsahuje následující parametry:
Param="WIZARD_UI = FALSE" Param="SOURCE_FILTER = txt"Soubor .VSZ může obsahovat následující parametry, které určují funkce, které jsou součástí souboru Common.js:
Param="PREPROCESS_FUNCTION = CanAddATLClass" Param="PREPROCESS_FUNCTION = CanAddMFCClass" Param="PREPROCESS_FUNCTION = CanAddClass"
Funkce CanAddATLClass, CanAddMFCClass a CanAddClass jsou volány průvodcem pro potvrzení, že model kódu Visual C++ je k dispozici. Pokud jedna funkce vrátí hodnotu false, průvodce se nespustí.
Průvodce lze přidat do podokna Šablony v dialogovém okně Nový projekt v sadě Visual Studio umístěním souboru .VSZ do adresáře vcprojects. Ve výchozím nastavení zapíše vlastní průvodce soubor .VSZ do tohoto adresáře.
Poznámka
Odstraníte-li soubory a adresáře průvodce, je také nutné odstranit projektový soubor .VSZ, soubor .VSDIR a soubor .ICO z adresáře vcprojects.
Viz také
Úkoly
Odkaz
Koncepty
Soubory vytvořené pro vašeho průvodce
Adding Wizards to the Add Item and New Project Dialog Boxes by Using .Vsdir Files