FormatSize コントロール属性

このビットが静的テキスト コントロールに設定されている場合、コントロールは自動的に表示されるテキストをバイト数を表す数値として書式設定しようとします。 適切な書式設定を行うには、コントロールのテキストに、512 バイト単位で表される数値を表す文字列を設定する必要があります。 表示される値は、キロバイト (KB)、メガバイト (MB)、またはギガバイト (GB) で書式設定され、単位を表す適切な文字列で表示されます。 詳細については、「テキスト コントロールの」を参照してください。

有効なコントロール

備考

コントロールにこの属性を設定するには、コントロールのレコードの Attributes 列の コントロール テーブルに FormatSize ビットを含めます。 コントロールのテキストは、512 バイト単位で表される数値を表す文字列に設定する必要があります。 単位文字列のテキストは、UIText Tableで定義されます。 単位文字列の配置は、LeftUnit プロパティによって制御されます。 LeftUnit プロパティが任意の値として定義されている場合、単位文字列は数値の前に表示されます。 コントロールに関連付けられているテキストに数値以外の文字が表示される場合、表示される値は未定義です。

インストーラーは実行時に、PrimaryVolumeSpaceRequired プロパティをインストールに必要な合計バイト数 (単位は 512) に解決します。 FormatSize ビットを持つ静的テキスト コントロールを使用すると、インストールに必要なバイト数の合計を KB、MB、または GB 単位で適切に自動的に書式設定およびラベル付けできます。 この例では、合計バイト数が 18,336,768 であると仮定します。 インストーラーは、PrimaryVolumeSpaceRequired プロパティの値を 18,336,768 を 512 または 35,814 で割った値に設定します。 FormatSize を使用してテキスト コントロールによって表示される数値は 17 MB です。

元のテキストの数値は 512 単位で指定されます。 上の表では、文字列 20,480 が KB 文字列に対応しています。これは、20,480 倍の 512 が 10,485,760 バイトまたは 10,240 KB の結果になるためです。

前の表に示した単位文字列は、UIText Tableのキーを参照します。ここで、単位文字列のテキストが定義されています。

単位文字列の配置は、LeftUnit プロパティによって制御されます。 LeftUnit プロパティが任意の値として定義されている場合、単位文字列は数値の前に表示されます。

コントロールに関連付けられているテキストに数値以外の文字が表示される場合、表示される値は未定義です。

詳細については、「コントロールの属性 および コントロールの」を参照してください。