FormatSize 控件属性

如果为静态文本控件设置了此位，该控件会自动尝试将显示的文本的格式设置为表示字节计数的数字。 为了正确设置格式，控件的文本必须设置为表示以 512 字节为单位的数字的字符串。 然后，显示的值采用千字节（KB）、兆字节（MB）或千兆字节（GB）格式，并用表示单位的相应字符串显示。 有关详细信息，请参阅 文本控件。

有效控件

言论

若要在控件上设置此属性，请在 控件表的控件记录的属性列中包括 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 表中的键，其中定义了单元字符串的文本。

单元字符串的位置由 LeftUnit 属性控制。 如果将 LeftUnit 属性定义为任何值，则单元字符串将显示在数值之前。

如果与控件关联的文本中出现数字字符以外的任何字符，则显示的值是未定义的。

有关详细信息，请参阅 控件属性 和 控件。