Text Control

Il controllo Testo visualizza testo statico, che può utilizzare uno stile predefinito.

Il metodo consigliato per la visualizzazione di testo con interruzioni di riga specificate consiste nell'usare più controlli di testo a riga uno sotto l'altro. Le sequenze di caratteri \n, \r\n o \n\r nel campo di testo per il controllo non vengono visualizzate come interruzione di riga. Queste sequenze di caratteri vengono visualizzate letteralmente dal controllo .

Attributi di controllo

È possibile utilizzare gli attributi seguenti con il controllo Text. 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
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 o BBControl. Usare le unità di installazione per lunghezza e distanza.
Text Testo visualizzato dal controllo . 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.
TimeRemaining Questo attributo consente a un controllo Text di visualizzare il numero approssimativo di minuti e secondi rimanenti per un'installazione. Sottoscrivere il controllo Text all'evento TimeRemaining ControlEvent nella tabella Eventmapping e immettere TimeRemaining nella colonna Attribute.
Il programma di installazione pubblica un record contenente un numero intero che rappresenta il numero di secondi rimanenti nell'installazione. Includere una riga nella tabella UIText con TimeRemaining nella colonna Chiave. Immettere una stringa di testo formattata nella colonna Testo creata per visualizzare minuti e secondi. Formattare questa stringa come descritto per MsiFormatRecord.
Visible 0x00000000 0x00000001
Controllo nascosto. Controllo visibile.
Includere questo bit nella parola bit della colonna Attributes nella tabella Control o nella tabella BBControl. 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 Attributes delle tabelle Control o BBControl 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.
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.
Trasparente 0x00000000 0x00010000
Controllo opaco. Lo sfondo viene visualizzato tramite il controllo . Il controllo ha lo stile WS_EX_TRANSPARENT.
Includere questo bit nella colonna Attributes delle tabelle Control o BBControl.
NoPrefix 0x00000000 0x00020000
Usare e in una stringa di testo per visualizzare il carattere successivo come carattere di sottolineatura. Il carattere e in una stringa viene visualizzato come se stesso.
Includere questo bit nella parola bit nella colonna Attributes delle tabelle Control o BBControl.
Nowrap 0x00000000 0x00040000
Ritorno a capo del testo. Il testo viene visualizzato su una singola riga. Se il testo si estende oltre i margini del controllo, viene ritagliato e vengono inseriti i puntini di sospensione ("...").
Includere questo bit nella parola bit nella colonna Attributes delle tabelle Control o BBControl.
UtentiLanguage 0x00000000 0x00100000
Tipi di carattere creati nella tabella codici del database. Tipi di carattere creati nella tabella codici predefinita dell'interfaccia utente dell'utente.
Attributo del controllo FormatSize 0x00000000 0x00080000
Formattato come testo. Se questo bit è impostato, il controllo tenta di formattare il testo visualizzato come numero che rappresenta un conteggio di byte. Per la formattazione corretta, il testo del controllo deve essere impostato su una stringa che rappresenta un numero espresso in unità di 512 byte. Il valore visualizzato verrà quindi formattato in termini di kilobyte (KB), megabyte (MB) o gigabyte (GB) e visualizzato con la stringa appropriata che rappresenta le unità.

 

Osservazioni:

Questo controllo può essere creato dalla classe STATIC usando la funzione CreateWindowEx. Ha gli stili SS_LEFT, WS_CHILD e WS_GROUP .

Non posizionare controlli Testo trasparente sopra le bitmap colorate. Il testo potrebbe non essere visibile se l'utente modifica la combinazione di colori di visualizzazione. Ad esempio, il testo può diventare invisibile se l'utente imposta il parametro a contrasto elevato per motivi di accessibilità.