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
Progettazione di una procedura guidata