FormatSize-Steuerelementattribut

Wenn dieses Bit für ein statisches Textsteuerelement festgelegt ist, versucht das Steuerelement automatisch, den angezeigten Text als eine Zahl zu formatieren, die eine Anzahl von Bytes darstellt. Für eine ordnungsgemäße Formatierung muss der Text des Steuerelements auf eine Zeichenfolge festgelegt werden, die eine Zahl darstellt, die in Einheiten von 512 Bytes ausgedrückt wird. Der angezeigte Wert wird dann in Kilobyte (KB), Megabyte (MB) oder Gigabyte (GB) formatiert und mit der entsprechenden Zeichenfolge angezeigt, die die Einheiten darstellt. Weitere Informationen finden Sie unter Text-Steuerelement.

Numerischer Wert des ursprünglichen Texts	Verwendete Einheitenzeichenfolge
Weniger als 20480	KB
Weniger als 20971520	MB
Weniger als 10737418240	GB

 

Gültige Steuerelemente

Decimal	Hexadezimal	Control
524288	0x00080000	msidbControlAttributesFormatSize

 

Bemerkungen

Um dieses Attribut für ein Steuerelement festzulegen, fügen Sie in der Control-Tabelle die FormatSize-Bits in die Attributes-Spalte des Datensatzes des Steuerelements ein. Der Text des Steuerelements muss auf eine Zeichenfolge festgelegt werden, die eine Zahl darstellt, die in Einheiten von 512 Bytes ausgedrückt wird. Der Text der Einheitenzeichenfolgen wird in der UIText-Tabelle definiert. Die Positionierung der Einheitenzeichenfolge wird durch die LeftUnit-Eigenschaft gesteuert. Wenn die LeftUnit-Eigenschaft als beliebiger Wert definiert ist, wird die Einheitenzeichenfolge vor dem numerischen Wert angezeigt. Wenn im dem Steuerelement zugeordnet Text etwas anderes als numerische Zeichen angezeigt werden, ist der angezeigte Wert nicht definiert.

Zur Laufzeit löst der Installer die PrimaryVolumeSpaceRequired-Eigenschaft in die Gesamtanzahl der für die Installation benötigten Bytes in Einheiten von 512 auf. Ein statisches Textsteuerelement mit FormatSize-Bit kann verwendet werden, um die Gesamtanzahl der für die Installation benötigten Bytes automatisch in KB, MB oder GB zu formatieren und zu bezeichnen. Nehmen Sie für dieses Beispiel an, dass die Gesamtzahl der Bytes 18.336.768 beträgt. Der Installer legt den Wert der PrimaryVolumeSpaceRequired-Eigenschaft auf 18.336.768 dividiert durch 512 bzw. 35.814 fest. Die Zahl, die vom Textsteuerelement mit FormatSize angezeigt wird, wäre 17 MB.

Die numerischen Werte des ursprünglichen Texts werden in Einheiten von 512 angegeben. In der obigen Tabelle entspricht die Zeichenfolge 20.480 der KB-Zeichenfolge, da 20.480 mal 512 als Ergebnis 10.485.760 Bytes oder 10.240 KB zurückgibt.

Die in der vorherigen Tabelle aufgeführten Einheitenzeichenfolgen beziehen sich auf Schlüssel in der UIText-Tabelle, in der der Text der Einheitenzeichenfolge definiert ist.

Die Positionierung der Einheitenzeichenfolge wird durch die LeftUnit-Eigenschaft gesteuert. Wenn die LeftUnit-Eigenschaft als beliebiger Wert definiert ist, wird die Einheitenzeichenfolge vor dem numerischen Wert angezeigt.

Wenn im dem Steuerelement zugeordnet Text etwas anderes als numerische Zeichen angezeigt werden, ist der angezeigte Wert nicht definiert.

Weitere Informationen finden Sie unter Steuerelementattribute und Steuerelemente.