共通的なプロパティ
ActiveReportsJSでは、デザイン時に各レポートコントロールを配置してレポートを作成します。各レポートコントロールには様々なプロパティがあり、それを設定することで様々な要件に対応することが可能です。
プロパティを設定する場合、デザイン面よりレポートコントロールを選択することで プロパティタブ に各種プロパティが表示されます。プロパティを設定方法は以下のようになっています。
スカラ値： デザイン時にString型、Number型、またはBoolean型の値を直接設定します。この場合、プレビュー時に値を変更することはできません。
String型の値を設定する場合はテキスト入力フィールドが、Number型の値を設定する場合はスピンボタンが、Boolean型の値を設定する場合はトグルボタンが表示されます。
列挙値： デザイン時にドロップダウンリストから値を選択する必要があります。
長さ： レポートコントロールのサイズや位置を示します。この形式のプロパティを設定する際、値（数値）と単位を設定する必要があります。
値： 長さやサイズを指定する数値を設定します。
単位： 使用する単位を設定します。使用可能な単位は以下の通りです。
pt（ポイント）
pc（パイカ）
in（インチ）
mm（ミリメートル）
cm（センチメートル）
式
式 とは各フィールドの値、プロパティ、共通の関数を利用して値を設定する数式です。数式の結果は、スカラ値、列挙値、長さのいずれかの形式になります。たとえば、プロパティがString型である場合、数式の結果は文字列にする必要があります。
数式にてデザイン時に評価できない値やレポートパラメータを参照している場合、実行時に結果を算出します。これは条件付き書式、または動的な可視性を設定する際に役立ちます。
式を変更するには、式エディタを使用することをお勧めします。 式エディタ を表示するには、プロパティの右側にある データ設定 アイコンをクリックし、ドロップダウンリストから ［式］ を選択します。
式エディタを使用する方法
プロパティの値をリセットしたい場合、同じように データ設定 アイコンをクリックし、ドロップダウンリストからに ［リセット］ を選択することで値を既定値にリセットすることが可能です。
コレクション
コレクションとは、同じ種類の項目を複数持つリストです。これに対して、項目は様々な種類のプロパティで構成されます。コレクションのプロパティは右側に ［項目の追加］ アイコンと ［項目の表示］ アイコンが表示されます。 ［項目の追加］ はコレクションに新しい項目を追加する際に使用します。 ［項目の表示］ は項目のリストを表示し、項目の削除または編集する際に使用します。
コレクションを使用する方法
基本的なプロパティ
すべてのレポートコントロールには、次のプロパティが用意されています。
共通
名前： レポートコントロールを識別する名前であり、エクスプローラに表示されます。
位置とサイズ
左・上： レポートの左上や、親コントロールの位置を基準にしたレポートコントロールの位置を設定します。
幅・高さ： レポートコントロールのサイズを設定します。
レイアウト
Z-Index： オブジェクトに含まれるレポートコントロールの描画順序を指定します。
レイヤー名：レポートコントロールが割り当てられる特定のレイヤーを指定します。
インターナショナル
方向： レポートコントロール内のテキストのデフォルトの方向を指定します。次のいずれかの値を指定できます。
LTR： テキストの方向は左から右になります。
RTL： テキストの方向は右から左になります。
言語： レポートコントロール内の日付と数値の書式設定に使用するデフォルトの言語を決定します。
文字表記の方向： レポートコントロール内のテキストを水平方向に配置するか垂直方向に配置するか、およびテキストの移動方向を設定します。次のいずれかの値を指定できます。
lr-tb： 方向が LTR の場合、テキストはは左から右へ水平方向に流れます。 RTL の場合、テキストは右から左へ水平方向に流れます。次の水平線は前の線の下に配置されます。
tb-rl： 方向が LTR の場合、テキストは上から下に垂直方向に流れ、次の垂直線は前の行の左側にあります。 RTL の場合、テキストは下から上に垂直方向に流れ、次の垂直線は前の線の右側にあります。
その他
ツールチップ： 実行時にレポートコントロールにカーソルを合わせたときに表示されるテキストを設定します。
ラベル： 目次およびTableOfContentsに表示されるテキストを設定します。
ブックマークID： アクションのJump To Bookmarkを使用する場合の移動先のブックマークIDとして設定します。
スタイル
背景
背景色： HTMLの色名または #face0d などの16進数の色を設定します。デザイン時に ［背景色］ プロパティの右側にあるドロップダウンリストを使用して色を選択できます。
画像： 背景画像を設定します。ドロップダウンエディタを使用して、画像を選択できます。
これらのタブのいずれかの項目を選択すると、次のプロパティが自動的に設定されます。これらのプロパティは、 ［画像］ プロパティの右側にある「展開」アイコンをクリックし、手動で構成することもできます。
ソース： 画像のソースを指定します。
External： ［共有］を使用した場合に設定されます。URLまたはローカルシステム上のファイルを選択しています。
Embedded： ［埋め込み］を使用した場合に設定されます。レポートの埋め込み画像より選択します。
Database： ［データベース］を使用した場合に設定されます。Base64 でエンコードされた画像を含むデータセットフィールドを選択します。
値： 画像IDを表す式。たとえばURLなどを設定します。
MIMEの種類： 画像の種類を指定する式。サポートされている種類は、jpeg、png、svgです。
背景画像の繰り返し表示： 背景画像のサイズがレポートコントロールのサイズよりも小さい場合、背景画像の配置を設定します。
Repeat： 使用可能なサイズを満たすために垂直方向と水平方向に繰り返します。
NoRepeat： 画像を1回だけ表示します。
RepeatX： 使用可能な幅を埋めるために水平方向に繰り返します。
RepeatY： 使用可能な高さを埋めるために垂直方向に繰り返します。
罫線： レポートコントロールの罫線の外観を設定するための次のプロパティを表示します。
幅： デフォルトの罫線の幅を設定します。
スタイル： デフォルトの罫線のスタイルを設定します。以下いずれかの値を選択します。
None
Dotted
Dashed
Solid
Double
Groove
Ridge
Inset
色： 罫線の色を設定します。
罫線の幅、スタイル、色は、レポートコントロールの上下左右の罫線に適用されます。個々の罫線を設定するには、プロパティの右側にあるアイコンをクリックし、設定したい方向の罫線のプロパティを個別に設定できます。
レイアウト
パディング： レポートコントロールのコンテンツの周囲に余白を設定します。既定はレポートコントロールの上下左右の境界線に適用されます。個々の境界線のパディング値を設定するには、プロパティの右側にあるアイコンをクリックし、設定したい方向のパディングのプロパティを個別に設定できます。
データ可視化
画像を編集するときに、外観 > 画像 > 値をクリックすると、［データの可視化］が表示されます。
［データの可視化］をクリックすると、次のオプションを構成できるダイアログが開かれます。
Data Bar： データバーはデータをバーの形で表示します。バーの高さはコントロールと同じです。
値： コントロール内で描画するバーの長さ（横幅）。この値がゼロ値と同じ場合には、バーは描画されません。
最小値： データ範囲の最小値。この値がバーの左端に相当します。この引数がゼロ値より大きい場合は、開始値がデータバーの最小値になります。
ゼロ値： バーの描画を開始する点の値。
最大値： データ範囲の最大値。この値がバーの右端に相当します。この引数がゼロ値より小さい場合は、開始値がデータバーの最大値になります。
色： バーの色を指定します。
代替色の使用： 値がゼロ値より小さい場合に使用するバーの色を指定します。
Hatch： ハッチは幾何学的なストライプの背景を表示します。
網掛けのスタイル： 網掛けのパターンをリストから選択します。
色１： グラデーションの開始色（プライマリ）を指定します。
色２： グラデーションの終了色（セカンダリ）を指定します。
Gradient： グラデーションは他の色に移り変わるような形で表示されます。
グラデーションの種類： グラデーションのパターンをリストから選択します。
色１： グラデーションの開始色（プライマリ）を指定します。
色２： グラデーションの終了色（セカンダリ）を指定します。
Icon Set： アイコンセットは式の結果に基づいて、定義されたリストからアイコンを表示します。
アイコンセット： 使用するアイコンセットの名前を指定します。
アイコン1の値～アイコン5の値： ブール型の式を設定します。［True］を選択した場合、アイコンセットからそれぞれ設定されたアイコンが描画されます。
アイコンセットに
3TrafficLightsを選択すると、［アイコン1の値］がTrueの場合は青信号を表示し、［アイコン2の値］がTrueの場合は黄信号を表示し、［アイコン3の値］がTrueの場合は赤信号を表示します。
Range Bar： レンジバーは2つのデータを2本のバーが重なった形で表示します。
最小値： データ範囲の最小値。この値がバーの左端に相当します。この引数が開始値より大きい場合は、開始値がレンジバーの最小値になります。
最大値： データ範囲の最大値。この値がバーの右端に相当します。この引数が開始値より小さい場合は、開始値がレンジバーの最大値になります。
開始値： バーの描画を開始する点の値。
長さ： コントロール内で描画するレンジバーの長さ（横幅）。
プログレスバーを表示： コントロール内でプログレスバーを表示するかを設定します。
プログレスバーの長さ： プログレスバーの長さ（横幅）。この値を「0」に設定すると、バーの代わりにダイアモンドが描画されます。
プログレスバーの色： プログレスバーの色を設定します。
テキスト
レポートコントロールとそのアイテムに表示されるテキストの外観を設定します。テキストには次のプロパティが用意されています。
色： テキストの色を設定します。HTMLの色名または #face0d などの16進数の色を設定します。
フォント名： テキストに使用するフォント名を設定します。
サイズ： フォントのサイズを指定します。
スタイル： テキストに使用するフォントのスタイルを設定します。設定できる値は以下の通りです。
Normal
Italic
太さ： テキスト内のフォントの太さを設定します。設定できる値は以下の通りです。
Lighter
Thin
ExtraLight
Light
Normal
Medium
SemiBold
Bold
Heavy
Bolder
文字飾り： 文字装飾を設定します。設定できる値は以下の通りです。
None
Underline
DoubleUnderline
Overline
LineThrough
水平方向の整列： テキストの配置を設定します。設定できる値は以下の通りです。
General： 数値と日付を右に、その他のすべて項目を左に揃えます。
Left： テキストを左揃えにします。
Right： テキストを右揃えにします。
Center： テキストを中央に配置します。
Justify： 各行が同じ幅になるように複数行のテキストを拡大します。
均等割付： このプロパティは［水平方向の整列］が Justify に設定されるときに使用されます。設定できる値は以下の通りです。
Auto： 最後の行を除いて、すべての行の単語間のスペースを変更します。
Distribute： 最後の行を除いて、すべての行の単語間のスペースを変更します。
DistributeAllLines： すべての行の単語間のスペースを変更します。
垂直方向の整列： コントロール内のテキストの垂直方向の配置を設定します。設定できる値は以下の通りです。
Top
Middle
Bottom
文字列の折り返し： 行末に達したときにテキストや単語の折り返し方法を設定します。設定できる値は以下の通りです。
NoWrap： 改行しません。
CharWrap： 文字単位で改行します。
WordWrap： 単語単位で改行します。
行間： 行の高さを設定し、CSSスタイルに変換します。
文字ピッチ： テキスト内の文字間のスペースを設定します。
表示
次のプロパティを使用して、レポートコントロールをプレビュー時に表示するかどうかを決定します。
非表示： 実行時のレポートコントロールの初期表示状態を設定します。プロパティを 「はい」 に設定すると、レポートコントロールは表示されません。既定では、 「いいえ」 が設定されます。
トグルスイッチにする項目： レポートコントロールの表示を制御するTextBoxの名前です。このプロパティを設定すると、指定されたTextBoxコントロールの左側に展開アイコン（+記号）と折りたたみアイコン（-記号）が表示されます。このアイコンをクリックすると、レポートが再描画され、レポートコントロールが表示または非表示になります。
グループ
改ページ： Container 、 List 、 Table 、 Tablix 、 BandedList で設定できます。設定できる値は以下の通りです。
None： 改ページを挿入しません。
Start： レポートコントロールの前に改ページを挿入します。
End： レポートコントロールの後に改ページを挿入します。
StartAndEnd： レポートコントロールの前後に改ページを挿入します。
Between： レポートコントロールの最初と最後を除いて前後に改ページを挿入します。