Finestra di dialogo dell'interfaccia utente Caselle di testo

Articolo
08/11/2011

Le finestre di dialogo Caselle di testo vengono utilizzate per visualizzare fino a quattro campi in cui l'utente potrà immettere del testo. Il contenuto di tali campi verrà poi restituito durante l'installazione. Sono disponibili tre finestre di dialogo Caselle di testo: Caselle di testo (A), Caselle di testo (B) e Caselle di testo (C). Le tre finestre di dialogo sono identiche. Ciascuna di esse può essere utilizzata soltanto una volta in un progetto di distribuzione.

Le finestre di dialogo contengono quattro caselle di testo a ognuna delle quali è associata un'etichetta, oltre a etichette aggiuntive utilizzate per fornire informazioni all'utente. Il testo delle etichette viene specificato in fase di progettazione nella finestra Proprietà. Per ciascuna casella di testo sono previste anche proprietà aggiuntive relative al controllo della visualizzazione, all'impostazione del testo predefinito e alla restituzione di un valore.

Nell'illustrazione riportata di seguito è raffigurata una tipica finestra di dialogo Caselle di testo, come visualizzata durante l'installazione.

Finestra di dialogo Caselle di testo

Schermata iniziale dell'interfaccia utente di distribuzione

Proprietà

Per la finestra di dialogo Caselle di testo sono disponibili le proprietà elencate di seguito.

Property	Oggetto di descrizione
BannerBitmap	Consente di specificare l'immagine bitmap o JPEG da visualizzare nell'area dell'intestazione. Nell'illustrazione precedente è visualizzata l'immagine bitmap predefinita. Per ulteriori informazioni, vedere Proprietà BannerBitmap.
BannerText	Consente di specificare il testo da visualizzare nell'area dell'intestazione. Nell'illustrazione precedente corrisponde a "This is the banner text".
BodyText	Consente di specificare il testo da visualizzare sopra alle caselle di testo. Nell'illustrazione precedente corrisponde a "This is the body text".
Edit1Label	Consente di specificare il testo da visualizzare sopra alla prima casella di testo. Nell'illustrazione precedente corrisponde a "First entry field".
Edit1Property	Consente di specificare il nome di una proprietà utilizzata per recuperare il testo immesso nella prima casella di testo. Questa proprietà può essere utilizzata nelle condizioni.
Edit1Value	Consente di specificare il valore (testo) iniziale della prima casella di testo.
Edit1Visible	Consente di specificare se la prima casella di testo è visibile o nascosta. Impostare questa proprietà su true nel caso di una finestra di dialogo con una o più caselle di testo.
Edit2Label	Consente di specificare il testo da visualizzare sopra alla seconda casella di testo. Nell'illustrazione precedente corrisponde a "Second entry field".
Edit2Property	Consente di specificare il nome di una proprietà utilizzata per recuperare il testo immesso nella seconda casella di testo. Questa proprietà può essere utilizzata nelle condizioni.
Edit2Value	Consente di specificare il valore (testo) iniziale della seconda casella di testo.
Edit2Visible	Consente di specificare se la seconda casella di testo è visibile o nascosta. Impostare questa proprietà su true nel caso di una finestra di dialogo con due o più caselle di testo oppure su false nel caso di una finestra di dialogo con una sola casella di testo.
Edit3Label	Consente di specificare il testo da visualizzare sopra alla terza casella di testo. Nell'illustrazione precedente corrisponde a "Third entry field".
Edit3Property	Consente di specificare il nome di una proprietà utilizzata per recuperare il testo immesso nella terza casella di testo. Questa proprietà può essere utilizzata nelle condizioni.
Edit3Value	Consente di specificare il valore (testo) iniziale della terza casella di testo.
Edit3Visible	Consente di specificare se la terza casella di testo è visibile o nascosta. Impostare questa proprietà su true nel caso di una finestra di dialogo con tre o più caselle di testo oppure su false nel caso di una finestra di dialogo con al massimo due caselle di testo.
Edit4Label	Consente di specificare il testo da visualizzare sopra alla quarta casella di testo. Nell'illustrazione precedente corrisponde a "Fourth entry field".
Edit4Property	Consente di specificare il nome di una proprietà utilizzata per recuperare il testo immesso nella quarta casella di testo. Questa proprietà può essere utilizzata nelle condizioni.
Edit4Value	Consente di specificare il valore (testo) iniziale della quarta casella di testo.
Edit4Visible	Consente di specificare se la quarta casella di testo è visibile o nascosta. Impostare questa proprietà su true nel caso di una finestra di dialogo con quattro caselle di testo oppure su false nel caso di una finestra di dialogo con al massimo tre caselle di testo.

Controllo dell'aspetto della finestra di dialogo Caselle di testo

Sono disponibili numerose proprietà che permettono di determinare come si presenterà all'utente la finestra di dialogo Caselle di testo durante l'installazione.

La proprietà BannerBitmap consente di controllare l'immagine visualizzata nell'angolo superiore destro della finestra di dialogo. La posizione e le dimensioni dell'immagine non sono modificabili.

Suggerimento

È consigliabile utilizzare la stessa immagine per tutte le finestre di dialogo del programma di installazione in modo da ottenere un'interfaccia utente coerente e uniforme.
La proprietà BannerText consente di controllare il testo visualizzato nell'intestazione posta nella parte superiore della finestra di dialogo. La posizione, le dimensioni e la dimensione del tipo di carattere non sono modificabili. Il testo può andare a capo, ma non può estendersi oltre le due righe.
La proprietà BodyText consente di controllare il testo visualizzato appena sotto la sezione dell'intestazione della finestra di dialogo. La posizione, le dimensioni e la dimensione del tipo di carattere non sono modificabili. Il testo può andare a capo, ma non può estendersi oltre le quattro righe.

Suggerimento
È consigliabile utilizzare la stessa immagine per tutte le finestre di dialogo del programma di installazione in modo da ottenere un'interfaccia utente coerente e uniforme.

Le proprietà EditNLabel consentono di controllare il testo delle etichette delle caselle di testo. La posizione e la dimensione del tipo di carattere non sono modificabili e il testo non può andare a capo.

Suggerimento
Se esiste la possibilità che le finestre di dialogo vengano localizzate, prevedere spazio per una eventuale espansione del testo. È infatti possibile che una parola, tradotta in un'altra lingua, diventi più lunga, con il rischio di un troncamento del testo.

Recupero dei dati immessi dall'utente mediante le proprietà della finestra di dialogo Caselle di testo

Quando viene eseguito il programma di installazione che contiene la finestra di dialogo Caselle di testo, l'utente può immettere informazioni in qualsiasi casella di testo visibile. È quindi possibile utilizzare tali informazioni in un'altra fase dell'installazione.

Può essere utile, ad esempio, creare una finestra di dialogo Caselle di testo che consente all'utente di immettere il nome di un gruppo di lavoro da archiviare in una voce del Registro di sistema. Data questa ipotesi, la proprietà Edit1Label potrebbe essere impostata su "Immettere il nome del proprio gruppo di lavoro". Inoltre, le proprietà Edit2Visible, Edit3Visible e Edit4Visible dovrebbero essere impostate su False in quanto è necessaria una sola casella di testo.

Nel caso gli utenti utilizzino in genere un gruppo di lavoro denominato "Predefinito", è possibile immettere Predefinito nella proprietà Edit1Value. Questa sarà la voce iniziale visualizzata all'utente nella casella di testo.

Nel Registro di sistema, la proprietà Condition della voce del Registro di sistema relativa al nome del gruppo di lavoro dovrebbe essere impostata sul valore della proprietà Edit1Property. Ad esempio, [EDITA1].

Durante l'installazione verrà valutata la proprietà Condition. Se l'utente immetterà un nome o accetterà il nome predefinito, esso verrà aggiunto al Registro di sistema; se invece il campo verrà lasciato vuoto, nel Registro di sistema non verrà creata alcuna voce.

Impostazione della condizione e del valore per le azioni personalizzate gestite

Quando si crea una UI per un'azione personalizzata gestita, è possibile impostare la condizione e il valore. Tuttavia, è possibile utilizzare la condizione e il valore solo sulla base delle proprietà dell'interfaccia utente personalizzate. Azioni personalizzate eseguite dopo che il programma di installazione è completato, pertanto non è possibile utilizzare proprietà dal progetto di installazione.