Finestre di dialogo (Windows Installer)

Le finestre di dialogo vengono specificate nella colonna Dialog della tabella Dialog. Per altre informazioni sull'aggiunta di una finestra di dialogo o di un cartellone a un'interfaccia utente, vedere Uso dell'interfaccia utente.

Nomi delle finestre di dialogo riservate

I nomi delle finestre di dialogo seguenti sono riservati da Windows Installer e non devono essere usati per le finestre di dialogo personalizzate create dall'utente. Il programma di installazione richiede che queste finestre di dialogo siano elencate nella tabella Dialog usando i seguenti nomi riservati. Ogni finestra di dialogo e nome può essere elencata una sola volta. Gli sviluppatori devono creare queste finestre di dialogo nell'interfaccia utente. Per informazioni su come visualizzare l'anteprima delle finestre di dialogo, vedere Importazione dell'interfaccia utente.

Nome della finestra di dialogo Breve descrizione della finestra di dialogo
Finestra di dialogo FilesInUse Avvisa l'utente per elaborare la sovrascrizione o l'eliminazione di file.
Finestra di dialogo FirstRun Raccoglie il nome utente, il nome della società e l'ID prodotto.
Finestra di dialogo MsiRMFilesInUse Avvisa l'utente di elaborare la sovrascrittura o l'eliminazione di file e consente all'utente di usare Gestione riavvio per chiudere e riavviare le applicazioni.

 

Finestre di dialogo obbligatorie

Durante l'installazione, alcuni eventi causano a Windows Installer di controllare le tabelle della sequenza dell'interfaccia utente nel pacchetto e visualizzare la finestra di dialogo specificata. Ad esempio, nel caso di un errore irreversibile, Windows Installer visualizza la finestra di dialogo elencata con un numero di sequenza di -3 nella tabella della sequenza dell'interfaccia utente indipendentemente dalla finestra di dialogo denominata nella tabella Dialog. Nella tabella seguente sono elencati gli eventi specifici e il relativo numero di sequenza corrispondente nella tabella della sequenza dell'interfaccia utente:

Tipo di evento Numero di sequenza della sequenza di sequenza dell'interfaccia utente Descrizione della finestra di dialogo
Errore irreversibile -3 L'installazione è stata terminata da un errore irreversibile.
Uscita dell'utente -2 L'installazione è stata terminata alla richiesta dell'utente.
Esci -1 L'installazione è stata completata correttamente.

 

Inoltre, l'autore del pacchetto deve creare una finestra di dialogo generica per visualizzare i messaggi di errore di Windows Installer. Questa finestra di dialogo può essere denominata qualsiasi elemento, ma questo nome deve essere specificato nella proprietà ErrorDialog .

Finestre di dialogo tipiche

Le finestre di dialogo seguenti sono facoltative e sono comunemente incluse nell'interfaccia utente creata di un pacchetto di installazione. Queste finestre di dialogo sono tipiche della maggior parte delle procedure guidate dell'interfaccia utente per l'installazione di file. Queste finestre di dialogo possono avere qualsiasi nome nella tabella Dialog. I nomi visualizzati sono consigliati solo per chiarezza e possono essere modificati in base alle esigenze. Ad esempio, due diverse finestre di dialogo LicenseAgreement personalizzate possono essere usate nel pacchetto e distinte nella tabella Dialog con i nomi ProfessionalLicenseAgreement e LimitedLicenseAgreement.

Tipo di finestra di dialogo Breve descrizione della finestra di dialogo
Finestra di dialogo DiskCost Indica spazio su disco insufficiente per l'installazione.
Finestra di dialogo Sfoglia Consente all'utente di selezionare una directory.
Finestra di dialogo Annulla Conferma una richiesta per terminare l'installazione.
Finestra di dialogo Contratto di licenza Box modale che visualizza il contratto di licenza.
Finestra di dialogo Selezione Casella modale che consente all'utente di selezionare gli elementi.