Atributo de controle FormatSize

Se esse bit estiver 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 uma 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. O valor exibido é então formatado em kilobytes (KB), megabytes (MB) ou gigabytes (GB) e exibido com a cadeia de caracteres apropriada que representa as unidades. Para obter mais informações, consulte Controle de texto.

Controlos válidos

Comentários

Para definir esse atributo em um controle, inclua os bits FormatSize na coluna Atributos do registro do controle no 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 no UIText Table. O posicionamento da cadeia de caracteres da unidade é controlado pelo LeftUnit Property. Se o LeftUnit Property for definido como qualquer valor, a cadeia de caracteres da unidade aparecerá 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 o PrimaryVolumeSpaceRequired Property para o número total de bytes necessários para a instalação em unidades de 512. Um controle de texto estático com 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 é 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 17MB.

Os valores numéricos do texto original são dados 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, onde o texto da cadeia de caracteres de unidade é definido.

O posicionamento da cadeia de caracteres da unidade é controlado pelo LeftUnit Property. Se o LeftUnit Property for definido como qualquer valor, a cadeia de caracteres da unidade aparecerá 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 Control Attributes e Controls.