GRAPH
GRAPH ( graphArea ; graphNumber ; xLabels {; yElements} {; yElements2 ; ... ; yElementsN} )
引数 | 型 | 説明 | |
---|---|---|---|
graphArea | ピクチャー変数 | 🡒 | ピクチャー変数 |
graphNumber | 倍長整数, オブジェクト | 🡒 | 倍長整数:グラフタイプ番号 オブジェクト(64-bit版のみ):グラフ設定 |
xLabels | 配列 | 🡒 | X軸ラベル |
yElements | 配列 | 🡒 | グラフにするデータ (最大8個) |
説明
GRAPHコマンドは、ピクチャー変数に、配列のデータを使用してグラフを作成します。
このコマンドで生成されるグラフは、統合されたSVGレンダリングエンジンを使用して描画され ます。グラフにはピクチャー変数に関連付けられたインターフェース機能があります。 (表示フォーマットの設定などに使用できる) アプリケーションモードのコンテキストメニュー、スクロールバー等。
注: SVG (Scalable Vector Graphics) はグラフィックファイルフォーマット (.svg 拡張子) です。XMLに基づき、このフォーマットは広く使用され、特にWebブラウザで表示できます。詳細は以下のWebサイトを参照してください: http://www.w3.org/Graphics/SVG/。SVG EXPORT TO PICTURE コマンドを使用して、統合されたSVGエンジンを利用することもできます。
graphPicture 引数にはフォーム中でグラフを表示するピクチャー変数名を渡します。
第二引数は、描画されるグラフタイプを指定します。これには二つのオプションがあります:
- Longint型である graphNumber引数を渡す (全てのバージョンの4Dで可能): この場合、1から8までの数値を渡す必要があります。グラフタイプについては例題1 に説明があります。グラフ描画後、graphNumを変更し、GRAPH コマンドをもう一度実行することでタイプを変更することができます。その後 GRAPH SETTINGS コマンドを呼び出す事で特定のグラフ特性を修正することができます。例題1を参照してください。
- Object型である graphSettings引数を渡す (ただしWindows用4D Serverではサポートされません): この場合、定義する様々なグラフ特性を含んだオブジェクトを渡す必要があります。このためには、"Graph Parameters" テーマ内にある定数を使用することができます (以下参照)。このシンタックスでは一回の呼び出しで、グラフタイプと同時に特定の設定 (凡例、xmin、等) を定義する事ができます。これにより、ユーザーは生成されたグラフを通常のSVGピクチャーとして保存し、FireFox、Chrome、IE、Safariなどの標準のブラウザーを使用してそれらを表示する事ができるようにします(生成されたグラフはブラウザーに埋め込まれているSVGスタンダードに追従します)。それに加え、このシンタックスではその他の様々な設定を変更できるため、例えばバーの間のスペース、マージン、バーの色等をカスタマイズすることができます。これについては例題2、3、4を参照して下さい。警告: このシンタックスを使用する場合、GRAPH SETTINGS コマンドは呼び出してはいけません。
引数 xLabels は、X軸(グラフの一番下)に使用するラベルを定義します。このデータは文字列、日付、時間、数値タイプのいずれでも構いません。 xLabels とyElementsの配列要素数はそれぞれ同じでなければなりません。
引数yElementsで指定するデータは、グラフにするデータです。このデータは数値でなければなりません。最大8つのデータセットをグラフ化することができます。円グラフは、最初のyElementsのみをグラフ化します。
自動ID
SVGグラフ中で見つけられる要素には自動 で特定のIDが割り当てられます:
ID | 説明 |
---|---|
ID_graph_1 ~ ID_graph_8 | 棒、折れ線、面... |
ID_graph_shadow_1 ~ ID_graph_shadow_8 | グラフの影... |
ID_bullet_1 ~ ID_bullet_8 | 点 (折れ線および散布図のみ) |
ID_pie_label_1 ~ ID_pie_label_8 | 円グラフのラベル (円グラフのみ) |
ID_legend | 凡例 |
ID_legend_1 ~ ID_legend_8 | 凡例のタイトル |
ID_legend_border | 凡例の境界線 |
ID_legend_border_shadow | 凡例境界線の影 |
ID_x_values | X軸の値 |
ID_y_values | Y軸の値 |
ID_y0_axis | Z軸の値 |
ID_background | 背景 |
ID_background_shadow | 背景の影 |
ID_x_grid | X軸のグリッド |
ID_x_grid_shadow | X軸のグリッドの影 |
ID_y_grid | Y軸のグリッド |
ID_y_grid_shadow | Y軸のグリッドの影 |
graphSettings属性
graphSettings引数を使用する場合、そこに定義したい様々なプロパティを含んだオブジェクトを渡します。"Graph Parameters"定数テーマ内にある、以下の定数を使用する事ができます:
定数 | 型 | 値 | コメント |
---|---|---|---|
Graph background color | 文字列 | graphBackgroundColor | とりうる値: SVG で使用可能な色名やRGB値 (テキスト)。 例: "#7F8E00"、"Pink"、"#0a1414" |
Graph background opacity | 文字列 | graphBackgroundOpacity | とりうる値: 0-100 の整数 デフォルトの値: 100 |
Graph background shadow color | 文字列 | graphBackgroundShadowColor | とりうる値: SVG で使用可能な色名やRGB値 (テキスト)。 例: "#7F8E00"、"Pink"、"#0a1414" |
Graph bottom margin | 文字列 | bottomMargin | とりうる値: 実数 デフォルトの値: 12 |
Graph colors | 文字列 | colors | とりうる値: テキスト配列。各グラフシリーズのカラー。 デフォルト値: Blue-green (#19BAC9), Yellow (#FFC338), Purple (#573E82), Green (#4FA839), Orange (#D95700), Blue (#1D9DF2), Yellow-green (#B5CF32), Red (#D43A26) |
Graph column gap | 文字列 | columnGap | とりうる値: 倍長整数 デフォルト値: 12 棒の間の空白を設定します。 タイプ1、2、3のみ |
Graph column width max | 文字列 | columnWidthMax | とりうる値: 実数 デフォルトの値: 200 タイプ1、2、3のみ |
Graph column width min | 文字列 | columnWidthMin | とりうる値: 実数 デフォルトの値: 10 |