FormatSize Control-Attribut

Wenn dieses Bit für ein statisches Textsteuerelement festgelegt ist, versucht das Steuerelement automatisch, den angezeigten Text als Zahl zu formatieren, die eine Anzahl von Bytes darstellt. Für die ordnungsgemäße Formatierung muss der Text des Steuerelements auf eine Zeichenfolge festgelegt werden, die eine Zahl darstellt, die in Einheiten von 512 Byte 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 Textsteuerelement.

Gültige Steuerelemente

Bemerkungen

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

Zur Laufzeit löst das Installationsprogramm die PrimaryVolumeSpaceRequired Property in die Gesamtanzahl der Bytes auf, die für die Installation in Einheiten von 512 erforderlich sind. Ein statisches Textsteuerelement mit FormatSize-Bit kann verwendet werden, um die Gesamtanzahl der Bytes, die für die Installation in KB, MB oder GB erforderlich sind, automatisch zu formatieren und zu bezeichnen. Gehen Sie für dieses Beispiel davon aus, dass die Gesamtanzahl der Bytes 18.336.768 beträgt. Das Installationsprogramm legt den Wert der PrimaryVolumeSpaceRequired-Eigenschaft auf 18.336.768 dividiert durch 512 oder 35.814 fest. Die vom Textsteuerelement mit FormatSize angezeigte Zahl 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 ein Ergebnis von 10.485.760 Bytes oder 10.240 KB liefert.

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

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

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

Weitere Informationen finden Sie unter Steuerelementattribute und Steuerelemente.