Share via

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 屬性定義為任何值，則單位字串會出現在數值之前。

如果與控制項相關聯的文字中出現數值字元以外的任何專案，則未定義顯示的值。

如需詳細資訊，請參閱 控制項屬性 和 控制項。