TextBox(テキストボックス)は、データを表示するために最も一般的に使用されるレポートコントロールです。TextBoxコントロールは、デフォルトでTableデータ領域、またはTablixデータ領域の各セルに表示されています。データエクスプローラからレポート上にフィールドをドラッグ&ドロップしたときに自動的に表示されるレポートコントロールもテキストボックスコントロールです。
テキストボックスのValueプロパティでは静的テキスト、または式を指定することができます。式を使用すると、データベースからフィールドの表示、値の計算やデータの表示を実現することができます。
「[プロパティ]ウィンドウ」で提供されているプロパティを使用して、テキストボックスの外観と動作を制御することができます。たとえば、Actionプロパティを設定して、ビューワをレポート内のブックマークに移動する機能や、他のレポートのブックマークに移動する機能、テキストボックスをクリックしたときにURLに移動する機能を設定することができます。DataElementプロパティでは、XML出力時にテキストボックスを表示するかどうかを設定することができます。
RDLレポートの場合、デフォルトとしてテキストボックスは表示するデータに応じて垂直方向に拡大することができますが、デザイン時に表示される規定のサイズより小さく縮小することはできません。この動作は、[プロパティ]ウィンドウのCanShrinkとCanGrowプロパティで設定可能です(この2つのプロパティは、ページレポートでは使用することができません)。
ユーザーがデータエクスプローラのデータセットからフィールドをドラッグして、レポート面上にドロップした場合、TextBoxコントロールとその式は自動的に作成されます。作成される式のタイプは、ドロップ先のコンテキストに依存します。次の表では、SalesAmountフィールドをレポート上にドラッグした場合を例として、作成されるいくつかの式を説明します。
複数コンテキストのフィールドのため作成された式
コンテキスト | 式 | 実行時の動作 |
---|---|---|
直接レポート面上 | =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出力時に表示されます。
[ツールヒント]: HTMLレポートでTITLE属性やALT属性を表示するために使用されるレポートアイテムのテキストラベル。
[値]: 式、または静的ラベルを入力するか、ドロップダウンリストからフィールド式を選択します。
メモ: 改ページが行われると、グループやデータセットは、重複値の最初のインスタンスが印刷されます。
[表示]
[レポートの初期実行時]
[次のレポートアイテムでの表示の切り替えを可能にする]: このチェックボックスをオンにすると、ユーザーがクリックしてテキストボックスの表示を切り替えるTextBoxコントロールを、その下にあるドロップダウンから指定することができます。
[画像の初期状態]: 以下のオプションから選択することができます。
[ナビゲーション]
ユーザーがテキストボックスをクリックした時に実行するアクションを以下のオプションから選択します。
なし: ユーザーが実行時にTextBoxをクリックしたとき、何もしません(デフォルト)。
レポートに移動: 別のレポートを表示する(ドリルスルーレポート)には、このオプションを選択して、ローカルレポートの名前を指定するか、別のフォルダ内にあるレポートの相対パス、あるいは別のサーバー上にあるレポートのフルパスを指定します。式を使用してドリルスルーリンクを作成することも可能です。
パラメータ: 対象となるレポートのパラメータの[名前]、対象レポートへ送信する[値]を指定して、またパラメータを[省略]するかどうかを指定します。ユーザーが指定するパラメータ名は、対象レポートのパラメータと正確に一致している必要があることに注意してください。[削除](X)ボタンを使用してパラメータの削除、矢印ボタンを使用してパラメータの順序の変更を行うことができます。
ブックマークに移動: このオプションを選択し、有効な[ブックマークID]を指定することで、ユーザーがそのブックマークIDを持つレポートアイテムに移動できます。
URLに移動: このオプションを選択し、有効なURLを指定して、Webページへのハイパーリンクを作成することができます。
[見出しマップラベル]: 目次(見出しマップ)にこのアイテムを表すためのラベルとして使用する式を入力します。
[ブックマークID]: このテキストボックスのロケータとして使用する式を入力します。次に、ブックマークに移動アクションを使用して、別のレポートコントロールからこの項目にブックマークリンクを提供することが可能となります。
[外観]
スタイル: 罫線のスタイルを選択します。
太さ: 罫線の太さを設定する値をポイント単位で入力します。
色: 罫線の色を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。
色: テキストボックスの背景に使用する色を設定します。
画像: テキストボックスの背景として設定する画像を選択します。
[フォント]
[フォント名]: フォントファミリー名、またはフォントのテーマを選択します。
[サイズ]: ポイント単位でサイズを選択するか、テーマを使用します。
[スタイル]: 「Normal」、「Italic」のいずれかを選択するか、テーマを選択します。
[太さ]: 「Lighter」、「Thin」、「ExtraLight」、「Light」、「Normal」、「Medium」、「SemiBold」、「Bold」、「ExtraBold」、「Heavy」、「Bolder」、「Bolder」の値から選択します。
[色]: テキストの色を選択します。
[文字飾り]: 「None」、「UnderLine」、「OverLine」、「LineThrough」、「DoubleUnderline」の値から選択します。
[書式]
[書式設定]: 一般的に提供される数値の任意書式を選択するか、日付や数値にカスタム.NETの書式設定コードを使用します。詳細情報については、MSDNの「型の書式設定」トピックを参照してください。
[行間]: 複数行がある場合のテキストの間隔を設定します。
[文字ピッチ]: 文字の間隔を設定します。
縮小して全体を表示する: このチェックボックスを選択すると、ShrinkToFitプロパティが「True」に設定されます。
方向: 左から右の場合は[LTR]を選択し、右から左の場合は[RTL]を選択します。
モード: テキストの書き込みが水平と垂直のどちらの方向に行われるかを示します。水平(左右)の場合は[lr-tb]を選択し、垂直の場合は[tb-rl](上下)を選択します。
縦中横:半角数字(0-9)、半角アルファベット(A-Z/a-z)、またはラテン文字を縦書きレイアウトで水平方向に表示するかを選択します。このプロパティは、[モード]プロパティが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>
Webデザイナに表示されるプロパティは、以下の通りです。
TextBox
カテゴリ | プロパティ | 説明 |
---|---|---|
全般 | 名前 | 名前を設定します。 |
値 | 表示するデータを設定します。 | |
アクション | 種類 | クリックしたときに実行するアクションを設定します。 |
背景 | 背景色 | 背景色を設定します。 |
画像 | 背景に表示する画像を設定します。 | |
罫線 | 太さ | 罫線の太さを設定します。 |
スタイル | 罫線の種類を設定します。 | |
色 | 罫線の色を設定します。 | |
テキスト | 色 | テキストの色を設定します。 |
フォント名 | フォントの種類を設定します。 | |
サイズ | フォントのサイズを設定します。 | |
スタイル | フォントのスタイルを設定します。 | |
太さ | フォントの太さを設定します。 | |
文字飾り | テキストの下、上、または中央に線を追加します。 | |
水平方向の整列 | テキストの水平方向の配置を設定します。 | |
均等割付 | テキストの位置揃え方法を設定します。[水平方向の整列]プロパティを「Justify」に設定した場合に有効になります。 | |
垂直方向の整列 | テキストの垂直方向の配置を設定します。 | |
文字列の折り返し | テキストのラップモードを設定します。 | |
行間 | 行の間隔を設定します。 | |
文字ピッチ | 文字の間隔を設定します。 | |
表示形式 | 日付、数値の表示書式を設定します。 | |
角度 | テキストを反時計回りに回転させる度数を設定します。 | |
縮小して全体表示 | レポートアイテムのサイズに合わせて、フォントのサイズを縮小するかどうかを設定します。 | |
最小縮小率 | 長体(テキスト幅の縮小)の下限を設定します。 | |
位置とサイズ | 左 | 左位置を設定します。 |
上 | 上位置を設定します。 | |
幅 | 幅を設定します。 | |
高さ | 高さを設定します。 | |
レイアウト | スタイル | スタイル名を設定します。 |
自動でマージ | 同じデータのテキストボックスを結合する方法を設定します。 | |
パディング | 罫線との間のパディング(余白)を設定します。 | |
レイヤー名 | 含まれるレイヤーの名前を設定します。 | |
1ページ内に収める | 1ページ内に収めて表示するかどうかを設定します。 | |
内容に応じて拡大 | 表示する内容に合わせて、高さを拡大するかどうかを設定します。 | |
内容に応じて縮小 | 表示する内容に合わせて、高さを縮小するかどうかを設定します。 | |
Zインデックス | レポートアイテム同士の重なりの優先順位を設定します。 | |
表示 | 非表示 | 非表示にするかどうかを設定します。 |
トグルスイッチにする項目 | 表示/非表示の切り替えに使うテキストボックスの名前を設定します。 | |
トグルの初期状態 | 表示/非表示を切り替えるアイコンの初期状態を設定します。 | |
データ | 要素名 | データ出力で使用する要素の名前を設定します。 |
要素出力 | データ出力でデータを出力するかどうかを設定します。 | |
要素のスタイル | データ出力で、要素として出力するか、属性として出力するかを設定します。 | |
ユーザー操作の並べ替え | 並べ替えの式 | 並べ替えの式を設定します。 |
並べ替えの式のスコープ | 並べ替えの式を評価するスコープを設定します。 | |
並べ替えの対象 | 並べ替える対象を設定します。 | |
インターナショナル | カレンダー | 日付の書式設定に使用するカレンダーを設定します。 |
方向 | テキストの表示方向を設定します(左書き、右書き)。 | |
言語 | テキストの主要言語を設定します。 | |
桁形式 | 桁形式を設定します。 | |
桁形式の言語変種 | 桁形式の変化形を設定します。 | |
Unicodeの文字表記の方向 | 左書き、右書きが混在する場合の文字表記の方向を設定します。 | |
縦中横 | 縦書きの中で特定の文字を横向き表示するかどうかを設定します。 | |
文字表記の方向 | テキストの表示方向を設定します(横書き、縦書き)。 | |
その他 | ツールチップ | カーソルを合わせたときに表示するテキストを設定します。 |
ラベル | 目次に表示するラベルを設定します。 | |
ブックマークID | ブックマークのIDを設定します。 | |
目次レベル | 目次のレベルを設定します。 |