FormatSize 控制項屬性
如果為靜態文字控制項設定此位,控制項會自動嘗試將顯示的文字格式化為代表位元組計數的數位。 若要進行適當的格式設定,控制項的文字必須設定為字串,此字串代表以 512 個位元組的單位表示的數位。 然後,顯示的值會格式化為 KB (KB) 、MB (MB) 或 GB (GB) ,並以代表單位的適當字串顯示。 如需詳細資訊,請參閱 文字控制項。
原始文字的數值 | 使用的單位字串 |
---|---|
小於 20480 | KB |
小於 20971520 | MB |
小於 10737418240 | GB |
有效控制項
Decimal | 十六進位 | 控制 |
---|---|---|
524288 | 0x00080000 | msidbControlAttributesFormatSize |
備註
若要在控制項上設定此屬性,請在控制項 資料表中控制項記錄的 Attributes 資料行中包含 FormatSize 位。 控制項的文字必須設定為字串,代表以 512 位元組為單位表示的數位。 單元字串的文字定義于 UIText 資料表中。 單位字串的位置是由 LeftUnit 屬性所控制。 如果 LeftUnit 屬性定義為任何值,則單位字串會出現在數值之前。 如果與控制項相關聯的文字中出現數值字元以外的任何專案,則未定義顯示的值。
在執行時間,安裝程式會將 PrimaryVolumeSpaceRequired 屬性解析為安裝單位為 512 所需的位元組總數。 具有 FormatSize 位的靜態文字控制項可用來視需要以 KB、MB 或 GB 自動格式化和標記安裝所需的位元組總數。 針對此範例的目的,假設位元組總數為 18,336,768。 安裝程式會將 PrimaryVolumeSpaceRequired 屬性的值設定為 18,336,768 除以 512 或 35,814。 使用 FormatSize 的文字控制項所顯示的數位會是 17MB。
原始文字的數值會以 512 的單位來指定。 在上表中,字串 20,480 對應至 KB 字串,因為 20,480 倍 512 會產生 10,485,760 個位元組或 10,240 KB 的結果。
上表中所列的單位字串是指 UIText Table中的索引鍵,其中定義了單位字串的文字。
單位字串的位置是由 LeftUnit 屬性所控制。 如果 LeftUnit 屬性定義為任何值,則單位字串會出現在數值之前。
如果與控制項相關聯的文字中出現數值字元以外的任何專案,則未定義顯示的值。