Udostępnij za pośrednictwem


Plik .Vsz (kontrola projektu)

Punktem wyjścia z każdego kreatora jest plik .vsz.Plik .vsz jest plik tekstowy, który określa Kreator ma być wywoływana i informacji do przekazania do kreatora.Plik zawiera nagłówek dwóch linii, następują różne parametry opcjonalne mają być przekazywane do kreatora.Aby uzyskać listę opcjonalnych parametrów, zobacz Wstępnie symbole kreatora niestandardowe.

Następujący przykład przedstawia nagłówka w pliku .vsz:

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.10.0
Param="WIZARD_NAME = My AppWizard"
  • Pierwszy wiersz nagłówka Określa numer wersji w formacie pliku szablonu.Można określić ten numer jako 6.0, 7.0, lub 7.1.Nie inne numery są prawidłowe i innych liczb powoduje błąd "Nieprawidłowy Format".

  • Drugi zestawów linii Kreatora zmienna identyfikatora ProgID kreatora, który jest cocreated przez program Visual Studio.Identyfikator ProgID jest reprezentacja ciąg identyfikatora klasy CLSID, takich jak VsWizard.VsWizardEngine.10.0.

    Jeśli Twój Kreator ma interfejs użytkownika, identyfikator ProgID automatycznie określa kreatora, aby zaimplementować IVCWizCtlUI.Domyślnie, metody tego interfejsu są używane w pliki .htm projektu.Działanie kreatora można zmienić za pomocą metody dla tego interfejsu w pliki .htm.Zobacz VCWizCtl Aby uzyskać więcej informacji, która jest coclass dla IVCWizCtlUI.

  • Po tych dwóch wierszy jest opcjonalna lista parametrów, które umożliwiają pliku .vsz do przekazywania dodatkowych parametrów niestandardowe do kreatora.Każda wartość jest przekazywana jako element string w tablicy warianty formantu kreatora Execute metody.Domyślnie Kreator interfejsu użytkownika daje następujące parametry domyślne:

    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>"
    

    Jeśli Kreator sieci nie ma interfejsu użytkownika, nie ma IMAGES_PATH parametr, ale zawiera następujące parametry:

    Param="WIZARD_UI = FALSE"
    Param="SOURCE_FILTER = txt"
    
  • Plik .vsz może zawierać następujące parametry, które określają funkcje znalezionych w Common.js pliku:

    Param="PREPROCESS_FUNCTION = CanAddATLClass"
    Param="PREPROCESS_FUNCTION = CanAddMFCClass"
    Param="PREPROCESS_FUNCTION = CanAddClass"
    

Funkcje CanAddATLClass, CanAddMFCClass, i CanAddClass są wywoływane przez kreatora Aby potwierdzić, że Visual C++ kod modelu jest dostępny.Jeśli jedna funkcja zwraca false, Kreator nie został uruchomiony.

Kreatora można dodać do okienka Szablony w Nowy projekt okno dialogowe w programie Visual Studio, umieszczając plik .vsz w katalogu vcprojects.Domyślnie Kreator niestandardowe zapisuje plik .vsz do tego katalogu.

[!UWAGA]

Jeśli usuniesz, Kreator plików i katalogów, .vsz pliku, plik .vsdir i plik .ico projektu musi również Usuń z katalogu vcprojects.

Zobacz też

Zadania

Tworzenie kreatora niestandardowego

Informacje

Kreator niestandardowy

Koncepcje

Pliki utworzone dla Twojego kreatora

Dodawanie kreatorów do okien dialogowych Dodawanie elementu i Nowy projekt za pomocą plików .Vsdir

Projektowanie kreatora

Inne zasoby

Model kreatorów Visual C++