FormatSize 控件属性

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

原始文本的数值	使用的单位字符串
少于 20480	KB
少于 20971520	MB
少于 10737418240	GB

 

有效控件

小数	十六进制	控制
524288	0x00080000	msidbControlAttributesFormatSize

 

备注

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

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

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

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