Condividi tramite


File VSZ (controllo progetto)

Il punto di partenza di ogni procedura guidata è rappresentato dal file VSZ, vale a dire un file di testo che determina la procedura guidata da chiamare e le informazioni da passare a essa. Il file contiene un'intestazione di due righe, seguita da vari parametri facoltativi da passare alla procedura guidata. Per l'elenco dei parametri facoltativi, vedere Simboli della creazione guidata personalizzata predefiniti.

Nell'esempio che segue è illustrata l'intestazione di un file VSZ.

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.10.0
Param="WIZARD_NAME = My AppWizard"
  • La prima riga dell'intestazione è il numero di versione del formato del file modello. È possibile specificare questo numero come 6.0, 7.0 o 7.1. Se si utilizza un qualsiasi altro numero, verrà visualizzato un messaggio di errore che informa che il formato non è valido.

  • La seconda riga imposta la variabile Wizard sul ProgID della procedura guidata che viene cocreata da Visual Studio. ProgID è una rappresentazione di stringa di un CLSID, come VsWizard.VsWizardEngine.10.0.

    Se la procedura guidata dispone di interfaccia utente, mediante il ProgID verrà automaticamente specificata l'implementazione di IVCWizCtlUI. Per impostazione predefinita i metodi di questa interfaccia vengono utilizzati nel file HTM del progetto. È possibile modificare il funzionamento della procedura guidata utilizzando i metodi di questa interfaccia nei file HTM. Per ulteriori informazioni, vedere VCWizCtl, la coclasse per IVCWizCtlUI.

  • Le due righe illustrate sono seguite da un elenco facoltativo di parametri che consentono il passaggio di parametri personalizzati aggiuntivi dal file VSZ alla procedura guidata. Ciascun valore viene passato come elemento di stringa in una matrice di varianti nel metodo Execute del controllo della procedura guidata. Per impostazione predefinita in una procedura guidata con interfaccia utente vengono prodotti i seguenti parametri predefiniti:

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

    Se la procedura guidata non prevede un'interfaccia utente, non disporrà di alcun parametro IMAGES_PATH e conterrà invece i seguenti parametri:

    Param="WIZARD_UI = FALSE"
    Param="SOURCE_FILTER = txt"
    
  • Nel file VSZ possono essere presenti i seguenti parametri, che specificano funzioni trovate nel file Common.js:

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

Le funzioni CanAddATLClass, CanAddMFCClass e CanAddClass vengono chiamate nella procedura guidata per confermare che il Modello codice di Visual C++ è disponibile. Se una funzione restituisce false, la procedura guidata non verrà avviata.

È possibile aggiungere la procedura guidata al riquadro Modelli nella finestra di dialogo Nuovo progetto di Visual Studio inserendo il file VSZ nella directory vcprojects. Per impostazione predefinita, il file VSZ viene scritto in questa directory durante la Creazione guidata personalizzata.

Nota

Se si eliminano i file e le directory della procedura guidata, è inoltre necessario eliminare i file VSZ, VSDIR e ICO dalla directory vcprojects.

Vedere anche

Attività

Creazione di una procedura guidata personalizzata

Riferimenti

creazione guidata personalizzata

Concetti

File creati per la procedura guidata

Aggiunta di procedure guidate alle finestre di dialogo Aggiungi elemento e Nuovo progetto tramite file vsdir

Progettazione di una procedura guidata

Altre risorse

Modello di procedura guidata Visual C++