GRAPHオブジェクト

グラフ用の文字列を生成するためのオブジェクトです。

<使用例>

GRAPH g;
NUMBER_ARRAY na;

// オプションの設定
g.AddOption("ScaleAdjustMode=exactly");
g.AddOption("ScaleMaxValue=100");

// 項目の設定
g.AddItems("英語,理科,算数,社会,国語");

// 系列（点数）の設定
g.AddValue(FALSE, "点数");
g.Add(GetNA("英語", 5));

// 系列（平均）の設定
na = GetNA("*英語-合計", 5);
na.Batch("/", GetRecordCount());
na.Batch("Round", 0);
g.AddValueLine(FALSE, "学年平均");
g.Add(na);

return g.GetGraphString();

<メソッド/プロパティ>

メソッド	説明
.Add	値を追加します。
.AddItem	項目を追加します。
.AddItems	複数の項目を追加します。
.AddOption	オプション文字列を追加します。
.AddValue .AddValueLine .AddValueLineEx	系列を追加します。
.Get	値を取得します。
.GetGraphString	グラフ設定文字列を取得します。
.Set	値を設定します。

.Addメソッド

値を追加します。
数値配列(NUMBER_ARRAY)を使って一括追加も行うことができます。

<構文>

obj.Add(値) As NUMBER

<戻り値>
なし。

<使用例>

GRAPH g;

g.AddItems("英語,理科,算数");
g.AddValue(FALSE,"点数");
g.Add(75);
g.Add(40);
g.Add(98);

return g.GetGraphString();

<使用例>

GRAPH g;
NUMBER_ARRAY na;

g.AddItems("英語,理科,算数");
g.AddValue(FALSE,"点数");
na.Add(75);
na.Add(40);
na.Add(98);
g.Add(na);

return g.GetGraphString();

<使用例>

GRAPH g;

g.AddItems("英語,理科,算数");
g.AddValue(FALSE, "点数");
g.Add(GetNA("英語", 3));

return g.GetGraphString();

<使用例>

GRAPH g;

// 項目名
g.AddItems("英語,理科,算数,社会,国語");

// Data1の1レコード目から点数の配列を設定
g.AddValue(FALSE, "点数");
g.Add(DATA_GetNA("Data1", "英語", 1, 5));

// Data1の2レコード目から平均の配列を設定
g.AddValue(FALSE, "平均");
g.Add(DATA_GetNA("Data1", "英語", 2, 5));

return g.GetGraphString();

<使用例>

GRAPH g;

// フィールド（年月）から日付（文字列）の配列を設定
g.AddItems(GetGroupFieldValueSA("Group_担当者", "年月"));

// フィールド（売上）から売上（数値）の配列を設定
g.AddValue(FALSE, "売上");
g.Add(GetGroupFieldValueNA("Group_担当者", "売上"));

return g.GetGraphString();

.AddItemメソッド

項目を追加します。

<構文>

obj.AddItem(項目名)

<戻り値>
なし。

<使用例>

GRAPH g;

g.AddItem("英語");
g.AddItem("理科");
g.AddItem("算数");

.AddItemsメソッド

複数の項目を追加します。

<構文>

obj.AddItem(項目名リスト)

<戻り値>
なし。

<使用例>

GRAPH g;

g.AddItems("英語,理科,算数");

.AddOptionメソッド

オプション文字列を追加します。

<構文>

obj.AddOption(オプション文字列)

<戻り値>
なし。

<使用例>

obj.AddOption("ScaleMaxValue=100");

.AddValueメソッド/AddValueLineメソッド/AddValueLineExメソッド

系列を追加します。

※
「縦」グラフ以外では使用できない機能があります。
AddValueLine/AddValueLineExは「縦」グラフでしか利用できません。
「円」「ドーナツ」では複数の系列を扱うことができません。

<構文>

obj.AddValue(nValueShow, 系列名, スタイル名) As NUMBER
obj.AddValueLine(nValueShow, 系列名, スタイル名, 分割数) As NUMBER
obj.AddValueLineEx(nValueShow, 系列名, スタイル名, 分割数) As NUMBER

<引数>

値	説明	省略時の値
nValueShow	値を表示する場合はTRUE 値を表示しない場合はFALSE を指定します。 ※ 第一引数にTRUEを指定できるのは「縦」グラフと「横」グラフだけです。他のグラフでは必ずFALSEを指定する必要があります。	FALSE
系列名	系列名を指定します。	""
スタイル名	スタイル名を指定します。	""
分割数	分割数を指定します。	1

<戻り値>
系列番号（0～）を戻します。

<使用例>

GRAPH g;

g.AddValue(FALSE, "点数");

.Getメソッド

値を取得します。

<構文>

obj.Get(項目番号 ) As NUMBER

<戻り値>
指定した項目の値を取得します。

.GetGraphStringメソッド

グラフ設定文字列を取得します。

<構文>

obj.GetGraphString( ) As STRING

<戻り値>
グラフ作成用文字列を戻します。

<使用例>

GRAPH g;

g.AddItems("英語,理科,算数");
g.AddValue(TRUE,"点数");
g.Add(75);
g.Add(40);
g.Add(98);

return g.GetGraphString();

この例では次の文字列を戻します。

Item=英語,理科,算数
*Value[点数]=75,40,98

.Setメソッド

値を設定します。

<構文>

obj.Set(項目番号, 値)

<戻り値>
指定した位置の値を変更します。