Attribut de contrôle FormatSize

Si ce bit est défini pour un contrôle de texte statique, le contrôle tente automatiquement de mettre en forme le texte affiché sous la forme d’un nombre qui représente un nombre d’octets. Pour une mise en forme correcte, le texte du contrôle doit être défini sur une chaîne représentant un nombre exprimé en unités de 512 octets. La valeur affichée est ensuite mise en forme en kilo-octets (Ko) ou gigaoctets (Go) et affichée avec la chaîne appropriée représentant les unités. Pour plus d’informations, consultez Contrôle de texte.

Valeur numérique du texte d’origine	Chaîne d’unité utilisée
Moins de 20480	Ko
Moins de 20971520	Mo
Moins de 10737418240	Go

 

Contrôles valides

Decimal	Valeur hexadécimale	Control
524 288	0x00080000	msidbControlAttributesFormatSize

 

Notes

Pour définir cet attribut sur un contrôle, incluez les bits FormatSize dans la colonne Attributes de l’enregistrement du contrôle dans la table Control. Le texte du contrôle doit être défini sur une chaîne représentant un nombre exprimé en unités de 512 octets. Le texte des chaînes d’unités est défini dans la table UIText. Le positionnement de la chaîne d’unité est contrôlé par la propriété LeftUnit. Si la propriété LeftUnit est définie comme une valeur quelconque, la chaîne d’unité apparaît avant la valeur numérique. Si quelque chose d’autre que des caractères numériques apparaît dans le texte associé au contrôle, la valeur affichée n’est pas définie.

Au moment de l’exécution, le programme d’installation résout la propriété PrimaryVolumeSpaceRequired en nombre total d’octets requis pour l’installation, en unités de 512. Un contrôle de texte statique avec le bit FormatSize peut être utilisé pour mettre en forme et étiqueter automatiquement le nombre total d’octets requis pour l’installation en Ko, Mo ou Go, le cas échéant. Pour les besoins de cet exemple, supposons que le nombre total d’octets est de 18 336 768. Le programme d’installation définit la valeur de la propriété PrimaryVolumeSpaceRequired sur 18 336 768 divisé par 512 ou 35 814. Le nombre affiché par le contrôle de texte avec FormatSize est de 17 Mo.

Les valeurs numériques du texte d’origine sont données en unités de 512. Dans le tableau ci-dessus, la chaîne 20 480 correspond à la chaîne Ko, car 20 480 fois 512 donne un résultat de 10 485 760 octets ou 10 240 Ko.

Les chaînes d’unités répertoriées dans la table précédente font référence aux clés de la table UIText, où le texte de la chaîne d’unité est défini.

Le positionnement de la chaîne d’unité est contrôlé par la propriété LeftUnit. Si la propriété LeftUnit est définie comme une valeur quelconque, la chaîne d’unité apparaît avant la valeur numérique.

Si quelque chose d’autre que des caractères numériques apparaît dans le texte associé au contrôle, la valeur affichée n’est pas définie.

Pour plus d’informations, consultez Attributs de contrôle et Contrôles.