PowerTools ActiveReports for .NET 11.0J > ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > ページレポート/RDLレポートのレポートコントロール > TextBox |
TextBox(テキストボックス)は、データを表示するために最も一般的に使用されるレポートコントロールです。TextBoxコントロールは、デフォルトでTableデータ領域、またはTablixデータ領域の各セルに表示されています。データエクスプローラからレポート上にフィールドをドラッグ&ドロップしたときに自動的に表示されるレポートコントロールもテキストボックスコントロールです。
テキストボックスのValueプロパティでは静的テキスト、または式を指定することができます。式を使用すると、データベースからフィールドの表示、値の計算やデータの表示を実現することができます。
ヒント: テキストボックスをダブルクリックして、レポートのデザイナ面で直接テキストを入力することができます。 |
「[プロパティ]ウィンドウ」で提供されているプロパティを使用して、テキストボックスの外観と動作を制御することができます。たとえば、Actionプロパティを設定して、ビューワをレポート内のブックマークに移動する機能や、他のレポートのブックマークに移動する機能、テキストボックスをクリックしたときにURLに移動する機能を設定することができます。DataElementプロパティでは、XML出力時にテキストボックスを表示するかどうかを設定することができます。
RDLレポートの場合、デフォルトとしてテキストボックスは表示するデータに応じて垂直方向に拡大することができますが、デザイン時に表示される規定のサイズより小さく縮小することはできません。この動作は、[プロパティ]ウィンドウのCanShrinkとCanGrowプロパティで設定可能です(この2つのプロパティは、ページレポートでは使用することができません)。
ユーザーがデータエクスプローラのデータセットからフィールドをドラッグして、レポート面上にドロップした場合、TextBoxコントロールとその式は自動的に作成されます。作成される式のタイプは、ドロップ先のコンテキストに依存します。次の表では、SalesAmountフィールドをレポート上にドラッグした場合を例として、作成されるいくつかの式を説明します。
複数コンテキストのフィールドのため作成された式
メモ: フィールドに文字列や不明なデータ型が含まれている場合は、作成される式が異なります。その場合は、Sumの代わりにFirstが式で使用されます。実行時には、集計値ではなく、スコープ内の最初の値が表示されます。 |
コンテキスト | 式 | 実行時の動作 |
---|---|---|
直接レポート面上 | =Fields!SalesAmount.Value | データセットの最初の値を表示します。 |
Listデータ領域 | =Fields!SalesAmount.Value | ページに表示されるリストのデータの各行の値を表示します。 |
BandedListデータ領域、ヘッダやフッタバンド | =Sum(Fields!SalesAmount.Value) | BandedListに関連付けるデータセットの売上額の集計を表示します。 |
BandedListデータ領域、詳細バンド | =Fields!SalesAmount.Value | ページに表示されるリストのデータの各行の値を表示します。 |
BandedListデータ領域、グループヘッダやフッタバンド |
=Sum(Fields!SalesAmount.Value) | グループ化のため売上額の集計を表示します。 |
Tableデータ領域、ヘッダやフッタ行 | =Sum(Fields!SalesAmount.Value) | Tableに関連付けるデータセットの売上額の集計を表示します。 |
Tableデータ領域、詳細行 | =Fields!SalesAmount.Value | ページに表示されるリストのデータの各行のため値を表示します。 |
Tableデータ領域、グループヘッダやフッタ行 |
=Sum(Fields!SalesAmount.Value) | グループ化のため売上額の集計を表示します。 |
Tablixデータ領域、コーナーセル | =Sum(Fields!SalesAmount.Value) | Tablixに関連付けるデータセットの売上額の集計を表示します。 |
Tablxデータ領域、列ヘッダセル | =Fields!SalesAmount.Value | 右側に表示されるデータの各行の新しい列では、一番上に値を表示します。 |
Tablixデータ領域、行ヘッダセル | =Fields!SalesAmount.Value | ページに表示されるデータの各行に対して、新しい行の左側に値を表示します。 |
Tablixデータ領域、詳細セル | =Sum(Fields!SalesAmount.Value) | 列と行が交わるセルに、売上額の集計を表示します。 |
TextBoxレポートコントロールの各プロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを表示するには、レポート上のTextBoxコントロールを選択した状態で、[プロパティ]ウィンドウ内にある[プロパティ設定ダイアログ]のリンクをクリックします。表示される[TextBox]ダイアログが、TextBoxコントロールのプロパティ設定ダイアログにあたります。
[TextBox]ダイアログでは、以下の各ページを使用してTextBoxコントロールのプロパティを設定できます。
メモ: プロパティの多くに用意されている<式...>オプションをクリックすると、[式エディタ]ダイアログが表示されます。このダイアログでは、値を決定する式を作成することができます。またValueプロパティの場合は、コントロールのコンテキストメニューからもアクセスできます。 |
[全般]
[名前]: まだレポートに使用されていない一意のTextBoxの名前を入力します。この名前は、[レポートエクスプローラ]の[ドキュメントアウトライン]ノード内、およびXML出力時に表示されます。
[ツールヒント]: 実行時にユーザーがTextBox上でポインタをホバーさせた際に表示させたい値、または式を入力します。
[値]: 式、または静的ラベルを入力するか、ドロップダウンリストからフィールド式を選択します。
メモ: 改ページが行われると、グループやデータセットは、重複値の最初のインスタンスが印刷されます。 |
[表示]
[レポートの初期実行時]
[次のレポートアイテムでの表示の切り替えを可能にする]: このチェックボックスをオンにすると、ユーザーがクリックしてテキストボックスの表示を切り替えるTextBoxコントロールを、その下にあるドロップダウンから指定することができます。
[画像の初期状態]: 以下のオプションから選択することができます。
[ナビゲーション]
ユーザーがテキストボックスをクリックした時に実行するアクションを以下のオプションから選択します。
なし: ユーザーが実行時にTextBoxをクリックしたとき、何もしません(デフォルト)。
レポートに移動: 別のレポートを表示する(ドリルスルーレポート)には、このオプションを選択して、ローカルレポートの名前を指定するか、別のフォルダ内にあるレポートの相対パス、あるいは別のサーバー上にあるレポートのフルパスを指定します。式を使用してドリルスルーリンクを作成することも可能です。
パラメータ: 対象となるレポートのパラメータの[名前]、対象レポートへ送信する[値]を指定して、またパラメータを[省略]するかどうかを指定します。ユーザーが指定するパラメータ名は、対象レポートのパラメータと正確に一致している必要があることに注意してください。[削除](X)ボタンを使用してパラメータの削除、矢印ボタンを使用してパラメータの順序の変更を行うことができます。
ブックマークに移動: このオプションを選択し、有効な[ブックマークID]を指定することで、ユーザーがそのブックマークIDを持つレポートアイテムに移動できます。
URLに移動: このオプションを選択し、有効なURLを指定して、Webページへのハイパーリンクを作成することができます。
[見出しマップラベル]: 目次(見出しマップ)にこのアイテムを表すためのラベルとして使用する式を入力します。
[ブックマークID]: このテキストボックスのロケータとして使用する式を入力します。次に、ブックマークに移動アクションを使用して、別のレポートコントロールからこの項目にブックマークリンクを提供することが可能となります。
[外観]
スタイル: 罫線のスタイルを選択します。
太さ: 罫線の太さを設定する値をポイント単位で入力します。
色: 罫線の色を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。
色: テキストボックスの背景に使用する色を設定します。
画像: テキストボックスの背景として設定する画像を選択します。
メモ: BackgroundColorとBackgroundImageプロパティは、<データの可視化>オプションも提供しています。このオプションのダイアログを使用してデータの可視化の式を作成することができます。 |
[フォント]
[フォント名]: フォントファミリー名、またはフォントのテーマを選択します。
[サイズ]: ポイント単位でサイズを選択するか、テーマを使用します。
[スタイル]: 「Normal」、「Italic」のいずれかを選択するか、テーマを選択します。
[太さ]: 「Lighter」、「Thin」、「ExtraLight」、「Light」、「Normal」、「Medium」、「SemiBold」、「Bold」、「ExtraBold」、「Heavy」、「Bolder」、「Bolder」の値から選択します。
[色]: テキストの色を選択します。
[文字飾り]: 「None」、「UnderLine」、「OverLine」、「LineThrough」の値から選択します。
[書式]
[書式設定]: 一般的に提供される数値の任意書式を選択するか、日付や数値にカスタム.NETの書式設定コードを使用します。詳細情報については、MSDNの「型の書式設定」トピックを参照してください。
[行間]: 複数行がある場合のテキストの間隔を設定します。
[行の高さ]: 複数行がある場合のテキストの高さ(レディングとアセントを含む)を設定します。
メモ: このプロパティはHTML出力の場合のみ影響があります。 |
[文字ピッチ]: 文字の間隔を設定します。
縮小して全体を表示する: このチェックボックスを選択すると、ShrinkToFitプロパティが「True」に設定されます。
方向: 左から右の場合は[LTR]を選択し、右から左の場合は[RTL]を選択します。
モード: テキストの書き込みが水平と垂直のどちらの方向に行われるかを示します。水平(左右)の場合は[lr-tb]を選択し、垂直の場合は[tb-rl](上下)を選択します。
角度: テキストを反時計回りに回転させる度数を入力します。テキストを時計回りに回転させるには負数を入力します。
[配置]
[縦位置]: 「Top」、「Middle」、「Bottom」の値から選択するか、<式...>を使用します。
[横位置]: 「General」、「Left」、「Center」、「Right」、「Justify」の値から選択するか、<式...>を使用します。
[均等割付]: [横位置]の値を「Justify」に設定してこのプロパティを有効にします。「Auto」、「Distribute」、「DistributeAllLines」の値から選択するか、<式...>を使用します。
[折り返し]: 「NoWrap」、「WordWrap」、「ChartWrap」から選択します。
[パディング]
[並べ替え]
[対話的な並べ替えを有効にする]のチェックボックスをオンして次に示すソート機能を有効にし、ユーザーがレポートデータを並べ替えできるようになります。
[並べ替えの式]: ソートするデータの確認するために使用する式を入力します。
[並べ替えの対象の選択]: レポート内にソートするグループレベルまたはデータ領域の1つを選択します。デフォルトでは「現在の範囲」に設定されていますが、「データ領域またはグループの選択」を選択することができます。
[以下の範囲に並べ替えの式を適用する]: 集計のソート式を評価するレポート内のグループレベルを選択します。デフォルトでは「現在の範囲」に設定されていますが、「データ領域またはグループの選択」を選択することができます。
[データ出力]
[要素名]: このテキストボックスをXML出力に使用する場合の名前を入力します。
[出力]: XML出力にこのテキストボックスを含めるかどうかを決定するため、「自動」、「はい」、「いいえ」の値から選択します。「自動」は、値が一定でない場合にのみテキストボックスの内容をエクスポートします。
[レンダリング]: 「自動」、「要素」、「属性」の値から選択して、エクスポートされたXMLファイルでテキストボックスを要素、属性のいずれとして表示するかを設定します。「自動」を選択すると、レポートの設定を使用します。
属性の例 : <table1 textbox3="Report created on:7/26/2005 1:13:00 PM">
要素の例 : <table1> <textbox3>Report created on:7/26/2005 1:13:28 PM</textbox3>