Text Control

Text コントロールは、定義済みのスタイルを使用できる静的テキストを表示します。

改行が指定されたテキストを表示するには、互いの下に配置された複数の 1 行テキスト コントロールを使用することをお勧めします。 コントロールのテキスト フィールドの文字シーケンス \n、\r\n、または \n\r は改行として表示されません。 これらの文字シーケンスは、コントロールによってそのまま表示されます。

コントロールの属性

Text コントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。

属性識別子	16 進数ビット	説明
Position		ダイアログ ボックス内のコントロールの位置。 Control テーブルまたは BBControl テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。
テキスト		コントロールによって表示されるテキスト。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。
TimeRemaining		この属性を使用すると、Text コントロールでインストールの残りのおおよその時間 (分と秒) を表示できます。 Eventmapping テーブルの TimeRemaining ControlEvent に Text コントロールをサブスクライブし、Attribute 列に TimeRemaining を入力します。 インストーラーは、インストールの残り秒数を表す 1 個の整数を含むレコードを発行します。 Key 列に TimeRemaining を含む行を UIText テーブルに含めます。 分と秒を表示するために作成した、書式設定したテキスト文字列を Text 列に入力します。 MsiFormatRecord の説明に従って、この文字列の書式を設定します。
[表示]	0x00000000 0x00000001	表示されないコントロール。 表示されるコントロール。 作成時にコントロールを表示または非表示にするには、Control テーブルまたは BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。 ControlCondition テーブルを使って、コントロールの非表示または表示を設定することもできます。
有効	0x00000000 0x00000002	無効状態のコントロール。 有効状態のコントロール。 作成時にコントロールを有効にするには、Control または BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。
Sunken	0x00000000 0x00000004	既定の表示スタイルを表示します。 浮き彫りの 3-D の外観を使用してコントロールを表示します。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。
RTLRO	0x00000000 0x00000020	コントロール内のテキストは、左から右への読み取り順序で表示されます。 コントロール内のテキストは、右から左への読み取り順序で表示されます。
RightAligned	0x00000000 0x00000040	コントロール内のテキストは、左揃えになります。 コントロール内のテキストは、右揃えになります。
透明	0x00000000 0x00010000	不透明なコントロール。 コントロールを通して背景が表示されます。 コントロールは、WS_EX_TRANSPARENT スタイルになります。 Control または BBControl テーブルの Attributes 列に、このビットを含めます。
NoPrefix	0x00000000 0x00020000	テキスト文字列内で & を使用して、次の文字をアンダースコア付きで表示します。 文字列内の文字 & は、それ自体として表示されます。 Control または BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。
NoWrap	0x00000000 0x00040000	テキストを折り返します。 テキストは 1 行に表示されます。 テキストがコントロールの余白に収まらない場合は、テキストは切り取られ、省略記号 ("...") が挿入されます。 Control または BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。
UsersLanguage	0x00000000 0x00100000	データベースのコード ページで作成されたフォント。 ユーザーの既定の UI のコード ページで作成されたフォント。
FormatSize コントロール属性	0x00000000 0x00080000	テキストとして書式設定されます。 このビットが設定されている場合、コントロールは表示されるテキストを、バイト数を表す数値として書式設定することを試みます。 適切な書式設定を行うには、コントロールのテキストを、512 バイト単位で表現される数値を表す文字列に設定する必要があります。 これで、表示される値は、キロバイト (KB)、メガバイト (MB)、またはギガバイト (GB) 単位で書式設定され、単位を表す適切な文字列と共に表示されます。

 

解説

このコントロールは、CreateWindowEx 関数を使用して、STATIC クラスから作成できます。 これには、SS_LEFT、WS_CHILD、WS_GROUP のスタイルがあります。

色付きのビットマップの上に透明なテキスト コントロールを配置しないでください。 ユーザーが表示配色を変更した場合、テキストが表示されなくなるおそれがあります。 たとえば、ユーザーがアクセシビリティ上の理由のためにハイ コントラスト パラメーターを設定すると、テキストが見えなくなることがあります。