Parametri di contesto per l'avvio delle procedure guidate

  • Articolo

I parametri di contesto rendono disponibili le informazioni necessarie per l'avvio di una procedura guidata, come il tipo di procedura guidata da utilizzare, il nome del progetto, le directory per gli elementi delle procedure guidate e così via.

Sono disponibili tre tipi diversi di procedure guidate:

  • NewProject: consente di aggiungere un nuovo progetto a una soluzione.

  • AddSubProject: consente di aggiungere un sottoprogetto a un progetto esistente.

  • AddItem: consente di aggiungere un elemento a un progetto esistente.

Tutti e tre i tipi di procedure guidate vengono chiamati tramite il metodo Execute dell'interfaccia IDTWizard. Uno dei parametri necessari del metodo Execute è ContextParams. Per ogni tipo è necessario disporre di un insieme di valori ContextParams diverso nell'ordine corretto, come indicato nella tabella riportata di seguito:

Tipo di procedura guidata

Parametri utilizzati

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

Nella tabella riportata di seguito sono elencati tutti i parametri di contesto e le relative descrizioni.

Impostazione

Descrizione

WizardType

Una costante che indica il tipo di procedura guidata, Sono disponibili tre tipi di procedure guidate:

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Il nome del progetto.

ProjectItems

Puntatore all'insieme ProjectItems su cui opererà la procedura guidata. Viene passato alla procedura guidata in base alla selezione della gerarchia del progetto.

LocalDirectory

Il percorso nel sistema locale in cui si trovano i file del progetto di lavoro della procedura guidata.

ItemName

Nome dell'elemento da aggiungere. ItemName è il nome del file che l'utente immette o accetta come predefinito nella finestra di dialogo Aggiungi elemento. A seconda dei flag impostati nel file VSDIR, questa impostazione può essere NULL.

InstallationDirectory

Percorso della directory in cui è installato Visual Studio.

FExclusive

Un valore booleano che indica se il progetto deve essere esclusivo all'interno della soluzione. Ovvero, se il progetto deve essere aggiunto alla soluzione corrente oppure se la soluzione corrente deve essere chiusa e deve essere creata una nuova soluzione all'interno della quale aggiungere il progetto.

SolutionName

Il nome del file della soluzione esclusa la parte della directory o l'estensione sln. Anche il nome del file suo si basa sul nome standard. Se SolutionName contiene un valore, ovvero non si tratta di una stringa vuota, la procedura guidata NewProject chiamerà il metodo Create prima di aggiungere al progetto il metodo AddFromTemplate. Se SolutionName è una stringa vuota, tuttavia, non sarà necessario chiamare il metodo Createprima di chiamare AddFromTemplate.

Silent

Valore Boolean che indica se la procedura guidata deve essere eseguita in modo invisibile all'utente, senza che venga visualizzata un'interfaccia utente e accettando tutti i valori predefiniti. Il valore predefinito di Silent è True.

Vedere anche

Riferimenti

Execute

IDTWizard

Concetti

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