Controllo di modifica (Windows Installer)

Il controllo Modifica è un campo di modifica associato a una proprietà stringa o valore intero. Immettere il nome della proprietà nella colonna Proprietà della tabella Control.

Attributi di controllo

È possibile usare gli attributi seguenti con questo controllo. Per modificare il valore di un attributo usando un evento, sottoscrivere il controllo a un Oggetto ControlEvent nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento ControlEvent nella colonna Evento.

Identificatore dell'attributo	Bit esadecimale	Descrizione
IndirectPropertyName		Si tratta del nome di una proprietà indiretta associata al controllo . Se il bit dell'attributo indiretto è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Se il bit dell'attributo indiretto è impostato, questo nome corrisponde anche al valore della proprietà elencata nella colonna Proprietà della tabella Control.
Posizione		Posizione del controllo nella finestra di dialogo. Immettere la larghezza, l'altezza e le coordinate del controllo nell'angolo sinistro del controllo nelle colonne Width, Height, X e Y della tabella Control. Usare le unità di installazione per lunghezza e distanza.
PropertyName		Si tratta del nome della proprietà associata a questo controllo. Se il bit dell'attributo indiretto non è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Questo attributo viene specificato nella colonna Property della tabella Control.
PropertyValue		Valore corrente della proprietà visualizzata o modificata da questo controllo. Se il bit dell'attributo indiretto non è impostato, questo è il valore di PropertyName. Se il bit dell'attributo indiretto è impostato, questo è il valore di IndirectPropertyName. Se l'attributo viene modificato, il controllo riflette il nuovo valore.
Text		Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere. Per specificare il numero di caratteri che l'utente può immettere, aggiungere {n} dopo qualsiasi specifica del tipo di carattere. Dove n è un numero intero positivo.
Visible	0x00000000 0x00000001	Controllo nascosto. Controllo visibile. Includere questo bit nella parola bit della colonna Attributes della tabella Control per rendere visibile o nascosto il controllo al momento della creazione. È anche possibile nascondere o visualizzare un controllo tramite la tabella ControlCondition.
Abilitato	0x00000000 0x00000002	Controllo in uno stato disabilitato. Controllo in uno stato abilitato. Includere questo bit nella parola bit nella colonna Attributi del controllo per abilitare il controllo alla creazione. È anche possibile abilitare o disabilitare un controllo tramite la tabella ControlCondition.
Affondata	0x00000000 0x00000004	Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto incassato, 3D. Includere questi bit nella parola bit nella colonna Attributi della tabella Control.
Indiretto	0x00000000 0x00000008	Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella Control. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella Control. Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente.
Integer	0x00000000 0x00000010	La proprietà associata al controllo è un valore stringa. La proprietà associata al controllo è un valore intero. Includere questo bit nella parola bit della colonna Attributes della tabella Control per impostare questo attributo alla creazione del controllo.
RTLRO	0x00000000 0x00000020	Il testo nel controllo viene visualizzato in ordine di lettura da sinistra a destra. Il testo nel controllo viene visualizzato in ordine di lettura da destra a sinistra.
RightAligned	0x00000000 0x00000040	Il testo nel controllo è allineato a sinistra. Il testo nel controllo è allineato a destra.
LeftScroll	0x00000000 0x00000080	La barra di scorrimento si trova sul lato destro del controllo. La barra di scorrimento si trova sul lato sinistro del controllo.
Bidi	0x000000E0	Impostare questo valore per una combinazione degli attributi RTLRO, RightAligned e LeftScroll .
Multilinea	0x00010000	Crea un controllo di modifica a più righe con una barra di scorrimento verticale. Includere 65536 nella parola bit nella colonna Attributi del controllo per creare un controllo di modifica a più righe con una barra di scorrimento verticale.
Password	0x00200000	Crea un controllo di modifica per l'immissione delle password. Aggiungere 2097152 al valore nella colonna Attributi della tabella Control per creare un controllo di modifica che visualizza ogni carattere come asterisco (*) mentre vengono digitati nel controllo . L'impostazione dell'attributo password impedisce al programma di installazione di scrivere la proprietà associata al controllo Modifica nel file di log. Per altre informazioni, vedere Impedire la scrittura di informazioni riservate nel file di log

Osservazioni:

Questo controllo può essere creato dalla classe EDIT usando la funzione CreateWindowEx. Ha gli stili di WS_BORDER, WS_CHILD, WS_TABSTOP e WS_GROUP .

La lunghezza del testo che può essere immesso può essere limitata inserendo un numero compreso tra 0 e 2147483646 tra parentesi graffe all'inizio del campo Testo nella tabella Control. Ad esempio, se il campo di testo inizia con {80}, la lunghezza della stringa è limitata a 80 caratteri. Se non viene specificato alcun limite di questo tipo nella tabella o se viene specificato 0, la lunghezza viene impostata sul massimo possibile (2147483646 caratteri). Un valore negativo o non numerico genererà un errore.

Per la compatibilità con le utilità per la lettura dello schermo, quando si crea una finestra di dialogo con un controllo Modifica come primo controllo attivo, è necessario impostare il campo di testo appartenente al campo di modifica il primo controllo attivo nella tabella Dialog. Poiché il testo statico non può assumere lo stato attivo, quando viene creata la finestra di dialogo il campo di modifica avrà inizialmente lo stato attivo come previsto, ma in questo modo si garantisce che le utilità per la lettura dello schermo visualizzino le informazioni corrette.

La proprietà associata al controllo Modifica viene impostata solo quando il controllo perde lo stato attivo. Pertanto, è necessario eseguire una scheda dal controllo o selezionare un controllo diverso per la proprietà da aggiornare.