Attributo di controllo FormatSize

Se questo bit è impostato per un controllo testo statico, il controllo tenta automaticamente 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 viene quindi formattato in kilobyte (KB), megabyte (MB) o gigabyte (GB) e visualizzato con la stringa appropriata che rappresenta le unità. Per altre informazioni, vedere Controllo testo.

Valore numerico del testo originale Stringa unità usata
Minore di 20480 KB
Minore di 20971520 MB
Minore di 10737418240 GB

 

Controlli validi

Decimal Valore esadecimale Control
524288 0x00080000 msidbControlAttributesFormatSize

 

Commenti

Per impostare questo attributo su un controllo, includere i bit FormatSize nella colonna Attributi del record del controllo nella tabella di controllo. Il testo del controllo deve essere impostato su una stringa che rappresenta un numero espresso in unità di 512 byte. Il testo delle stringhe di unità viene definito nella tabella UIText. La posizione della stringa di unità è controllata dalla proprietà LeftUnit . Se la proprietà LeftUnit è definita come qualsiasi valore, la stringa di unità viene visualizzata prima del valore numerico. Se qualsiasi elemento diverso da caratteri numerici viene visualizzato nel testo associato al controllo, il valore visualizzato non è definito.

In fase di esecuzione, il programma di installazione risolve la proprietà PrimaryVolumeSpaceRequired al numero totale di byte necessari per l'installazione in unità 512. Un controllo testo statico con FormatSize bit può essere usato per formattare automaticamente ed etichettare il numero totale di byte necessari per l'installazione in KB, MB o GB in base alle esigenze. Ai fini di questo esempio, si presuppone che il numero totale di byte sia 18,336,768. Il programma di installazione imposta il valore della proprietà PrimaryVolumeSpaceRequired su 18.336.768 diviso per 512 o 35.814. Il numero visualizzato dal controllo di testo con FormatSize sarà 17 MB.

I valori numerici del testo originale vengono assegnati in unità di 512. Nella tabella precedente la stringa 20.480 corrisponde alla stringa KB perché 20.480 volte 512 restituisce un risultato di 10.485.760 byte o 10.240 KB.

Le stringhe di unità elencate nella tabella precedente fanno riferimento alle chiavi nella tabella UIText, in cui viene definito il testo della stringa di unità.

La posizione della stringa di unità è controllata dalla proprietà LeftUnit . Se la proprietà LeftUnit è definita come qualsiasi valore, la stringa di unità viene visualizzata prima del valore numerico.

Se qualsiasi elemento diverso da caratteri numerici viene visualizzato nel testo associato al controllo, il valore visualizzato non è definito.

Per altre informazioni, vedere Attributi e controlli di controllo.