# AddPen

マニュアル > コントロールリファレンス > データ > ヒストリカルトレンドグラフコントロール > メソッド > # AddPen |

| ペンの追加を行う。 構文 AddPen( Title, Unit, Color, DataType, ProtType, Low, High, DisplayLow, DisplayHigh, DataSource ) パラメータ
Title
| 型： | 文字
| タイトル（左中央に表示される）。
Unit
| 型： | 文字
| 単位（タイトルと共に左中央に表示される）。
Color
| 型： | 色文字
| グラフの線の色。"default"を指定すると自動的に最適な色が設定されます。
DataType
| 型： | 文字
| データタイプ。"boolean" "analog" "enumeration"から選択します。ビットのデータはbooleanを指定します。数値型のデータはanalogを選択します。enumerationは、小数点以下が四捨五入され、整数のデータとして扱われます。
PlotType
| 型： | 文字
| プロットタイプ。"periodic" "changebased" から選択します。periodicの場合、プロットの点が結ばれてグラフの線が描画されます。changebasedの場合、階段状にグラフの線が描画されます。ビットの場合通常changebasedを選択します。
Low
| 型： | 数値
| データの最小値。最小値より小さいデータは表示されません。
High
| 型： | 数値
| データの最大値。最大値より大きいデータは表示されません。
DisplayLow
| 型： | 数値
| 表示範囲の下位置。0から100までの範囲で指定します。表示範囲とは、Y軸の最上位置及び最小位置がグラフのどこに位置するのかを％で表現します。例えば表示範囲開始が20％で表示範囲終了を40％と設定すると、グラフエリア内でのグラフ描画は、グリッドの下から20％の位置から40％の位置までの範囲で描画が行われます。
DisplayHigh
| 型： | 数値
| 表示範囲の上位置。0から100までで指定します。
DataSource
| 型： | 文字
| ヒストリカルデータサーバで設定したデータソースを指定します。例えば"A01.F02"は、ヒストリカルデータサーバA01アクションのF02フィールドを示します。異なるヒストリカルデータサーバのデータを１つのグラフで表示してもかまいません。例えば、A01.F01とA02.F01を混在させて表示できます。
戻り値
| 型： | ブール
| FALSE - 失敗。TRUE - 成功。
解説
追加できるペンの数には制限ありません。但し、あまり多くのペンを一度に表示すると速度が遅くなりますので注意してください。 追加したペンは1から順番にペン番号が付与されます。例えば、最初に追加したペンの番号は1で、8個目に追加したペンの番号は8になります。
参照 AddPen InsertPen DelPen ClearPen SelectPen GetSelectedPen GetPenCount GetPenPlotSize SetPenPlotSize