Atributo de controle FormatSize

Se esse bit for definido para um controle de texto estático, o controle tentará formatar automaticamente o texto exibido como um número que representa uma contagem de bytes. Para formatação adequada, o texto do controle deve ser definido como uma cadeia de caracteres que representa um número expresso em unidades de 512 bytes. Em seguida, o valor exibido é formatado em quilobytes (KB), megabytes (MB) ou GB (gigabytes) e exibido com a cadeia de caracteres apropriada que representa as unidades. Para saber mais, confira Controle de texto.

Valor numérico do texto original Cadeia de caracteres de unidade usada
Menor do que 20480 KB
Menor do que 20971520 MB
Menor do que 10737418240 GB

 

Controles válidos

Decimal Hexadecimal Control
524288 0x00080000 msidbControlAttributesFormatSize

 

Comentários

Para definir esse atributo em um controle, inclua os bits FormatSize na coluna Atributos do registro do controle na Tabela de Controle. O texto do controle deve ser definido como uma cadeia de caracteres que representa um número expresso em unidades de 512 bytes. O texto das cadeias de caracteres de unidade é definido na tabela UIText. O posicionamento da cadeia de caracteres de unidade é controlado pela Propriedade LeftUnit . Se a Propriedade LeftUnit for definida como qualquer valor, a cadeia de caracteres de unidade será exibida antes do valor numérico. Se algo diferente de caracteres numéricos aparecer no texto associado ao controle, o valor exibido será indefinido.

Em tempo de execução, o instalador resolve a Propriedade PrimaryVolumeSpaceRequired para o número total de bytes necessários para a instalação em unidades de 512. Um controle de texto estático com o bit FormatSize pode ser usado para formatar e rotular automaticamente o número total de bytes necessários para a instalação em KB, MB ou GB conforme apropriado. Para os fins deste exemplo, suponha que o número total de bytes seja 18.336.768. O instalador define o valor da propriedade PrimaryVolumeSpaceRequired como 18.336.768 dividido por 512 ou 35.814. O número exibido pelo controle de texto com FormatSize seria de 17 MB.

Os valores numéricos do texto original são fornecidos em unidades de 512. Na tabela acima, a cadeia de caracteres 20.480 corresponde à cadeia de caracteres KB porque 20.480 vezes 512 produz um resultado de 10.485.760 bytes ou 10.240 KB.

As cadeias de caracteres de unidade listadas na tabela anterior referem-se a chaves na Tabela UIText, em que o texto da cadeia de caracteres de unidade é definido.

O posicionamento da cadeia de caracteres de unidade é controlado pela Propriedade LeftUnit . Se a Propriedade LeftUnit for definida como qualquer valor, a cadeia de caracteres de unidade será exibida antes do valor numérico.

Se algo diferente de caracteres numéricos aparecer no texto associado ao controle, o valor exibido será indefinido.

Para obter mais informações, confira Atributos de controle e Controles.