Atributo de control FormatSize

Si este bit se establece para un control de texto estático, el control intenta dar formato automáticamente al texto mostrado como un número que representa un recuento de bytes. Para un formato adecuado, el texto del control debe establecerse en una cadena que represente un número expresado en unidades de 512 bytes. A continuación, se da formato al valor mostrado en kilobytes (KB), megabytes (MB) o gigabytes (GB) y se muestra con la cadena adecuada que representa las unidades. Para obtener más información, vea Control de texto.

Valor numérico del texto original	Cadena de unidad usada
Menos de 20480	KB
Menos de 20971520	MB
Menos de 10737418240	GB

 

Controles válidos

Decimal	Hexadecimal	Control
524 288	0x00080000	msidbControlAttributesFormatSize

 

Observaciones

Para establecer este atributo en un control, incluya los bits FormatSize en la columna Attributes del registro del control en la tabla Control. El texto del control debe establecerse en una cadena que represente un número expresado en unidades de 512 bytes. El texto de las cadenas de unidad se define en la tabla UIText. La posición de la cadena de unidad se controla mediante la propiedad LeftUnit. Si la propiedad LeftUnit se define como cualquier valor, la cadena de unidad aparece antes del valor numérico. Si en el texto asociado al control aparece cualquier otra cosa que no sean caracteres numéricos, el valor mostrado será indefinido.

En tiempo de ejecución, el instalador resuelve la propiedad PrimaryVolumeSpaceRequired en el número total de bytes necesarios para la instalación en unidades de 512. Se puede usar un control de texto estático con el bit FormatSize para dar formato automáticamente y etiquetar el número total de bytes necesarios para la instalación en KB, MB o GB según corresponda. Para los fines de este ejemplo, supongamos que el número total de bytes es 18.336.768. El instalador establece el valor de la propiedad PrimaryVolumeSpaceRequired en 18.336.768 dividido entre 512 o 35.814. El número mostrado por el control de texto con FormatSize sería de 17 MB.

Los valores numéricos del texto original se proporcionan en unidades de 512. En la tabla anterior, la cadena 20 480 corresponde a la cadena de KB porque 20 480 veces 512 produce un resultado de 10 485 760 bytes o 10 240 KB.

Las cadenas de unidad enumeradas en la tabla anterior hacen referencia a las claves de la tabla UIText, donde se define el texto de la cadena de unidad.

La posición de la cadena de unidad se controla mediante la propiedad LeftUnit. Si la propiedad LeftUnit se define como cualquier valor, la cadena de unidad aparece antes del valor numérico.

Si en el texto asociado al control aparece cualquier otra cosa que no sean caracteres numéricos, el valor mostrado será indefinido.

Para obtener más información, vea Atributos de control y Controles.