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 gigabytes (GB) e exibido com a cadeia de caracteres apropriada que representa as unidades. Para obter mais informações, consulte de Controle de Texto.
| Valor numérico do texto original | Cadeia de caracteres de unidade usada |
|---|---|
| Menor que 20480 | KB |
| Menos de 20971520 | MB |
| Menos de 10737418240 | GB |
Controles válidos
| Decimal | Hexadecimal | Controle |
|---|---|---|
| 524288 | 0x00080000 | msidbControlAttributesFormatSize |
Observações
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 são definidos no da 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 propriedadePrimaryVolumeSpaceRequiredpara 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 fins deste exemplo, suponha que o número total de bytes seja de 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 no de 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, consulte atributos de controle e controles de .