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.