PowerTools ActiveReports for .NET 9.0J > ActiveReportsユーザーガイド > 概念 > セクションレポートの概念 > セクションレポートのレポートコントロール > RichTextBox |
ActiveReportsでは、RichTextBoxコントロールは書式付きテキストを表示、挿入または操作するために使用されます。このコントロールはいくつかの面でTextBoxコントロールとは異なりますが、内容を部分的に異なる書式で設定できる点は、最も大きな違いです。
RichTextBoxコントロールには、デザイン時や実行時にもRTFファイルをロードできます。そして、実行時に値を代入するフィールドプレースホルダを含むフィールドマージレポートを作成できます。コントロールを右クリックして[フィールドの挿入]オプションを選択して直接入力したテキストにフィールドを追加できます。
詳細については、「RichTextBoxコントロールにファイルのロード」と「リッチテキストとフィールドのマージ」を参照してください。
主なプロパティ
プロパティ | 解説 |
---|---|
AutoReplaceFields | 「True」の場合、コントロール内のフィールドをデータソースのフィールドデータで置換えます。 |
CanGrow | コントロールの内容に合わせて、コントロールの高さを拡大するかどうかを判定します。 |
CanShrink | フィールドの値に応じて、フィールドの高さを縮小するかどうかを判定します。 |
MultiLine | RichTextBoxで複数行を印刷するか、単一行のみを印刷するかを取得または選択します。 |
DataField | データソースのコントロールに連結するフィールドの名前を取得または設定します。 |
ショートカットキー
直接編集モードでは、以下のキーコマンドを使用できます。
キーシーケンス | 動作 |
---|---|
Enter | 改行 |
Alt + Enter | 変更を保存し、編集モードを終了します。 |
Esc | 変更を保存しないで、編集モードを終了します。 |
エンドユーザデザイナでこの機能を無効にしたい場合は、EditModeEnteringおよびEditModeExitイベントを使用してください。
レポート上にコントロールを選択した状態で、[プロパティ]ウインドウの下部にあるコマンドから[ファイルを開く]をクリックしてダイアログを開きます。これにより、デザイン時にコントロールにRichText(*.rtf)ファイルを読み込むことができます。
実行時にレポート内にファイルを読み込む場合、Loadメソッドを使用します。詳細については、「Load メソッド」を参照してください。
レポート上のコントロールを選択した状態で、[プロパティ]ウインドウの下部にあるコマンドから[プロパティ設定ダイアログ]をクリックしてダイアログを開きます。
[全般]
[名前] : レポートに使用されていないユニークなRichTextBoxの名前を入力します。この名前はドキュメントの要素およびXML出力で表示します。
[タグ] : コントロールに付随する文字列を入力します。コード上でこのプロパティをアクセスするとオブジェクトとして認識されていますが、[プロパティ]ウィンドウまたは[プロパティ設定ダイアログ]では文字列となります。
[表示する]: コントロールを非表示にするには、このチェックボックスを外します。
[データフィールド]: コントロールにバインドするデータソースのフィールドを選択します。
[最大文字数]: コントロール内に表示する最大文字数を入力します。最大文字数を指定しない場合は、無限の文字数が表示されます。
[データソースで置き換え]: コントロール内のフィールドをデータソースのフィールドデータで置換する場合、このチェックボックスを選択します。
[外観]
[背景色]: RichTextBoxの背景色を設定します。
[書式]
[コントロールに合わせて拡大する] : [CanGrow]プロパティを「True」に設定するためにこのチェックボックスを選択します。
[コントロールに合わせて縮小する] : [CanShrink]プロパティを「True」に設定するためにこのチェックボックスを選択します。
[複数行を表示]: コントロール内に複数行を表示するかどうかを設定します。