addPlotLine (ChartObject method)

축에 기준선(plotLine)을 추가합니다.
추가한 기준선은 속성에도 반영되어 draw()로 다시 그려도 유지됩니다. 차트가 그려지기 전(draw() 호출 전)에 호출하면 -1을 반환합니다.

Syntax

{ibchart}.addPlotLine(axisType, line, [index]);

Parameters

Name	Type	Required	Description
`axisType`	`string`	필수	축 종류 (`xAxis`, `yAxis`)
`line`	`object`	필수	기준선 속성
`line.value`	`number`	필수	기준선 위치 값
`line.color`	`color`	선택	선 색상
`line.width`	`number`	선택	선 두께(px)
`line.dashStyle`	`string`	선택(Solid)	선 모양 (`Solid`, `Dash`, `Dot` 등)
`line.label`	`object`	선택	라벨 속성 (`text`, `align`, `style` 등)
`line.id`	`string`	선택	기준선 id. 생략하면 자동으로 만들어 반환합니다. 기준선을 구분할 임의의 문자열 (예: `"goal"`). 생략하면 `"ib-plotLines-1"` 형식으로 자동 생성됩니다.
`index`	`number`	선택(0)	축 인덱스

Returns

string 추가된 기준선의 id, 실패 시 -1

Example

// y축 50 위치에 목표선 추가
var lineId = myChart.addPlotLine("yAxis", {
  value: 50,
  color: "#FF0000",
  width: 2,
  dashStyle: "Dash",
  label: { text: "목표" }
});

// 제거
myChart.removePlotLine("yAxis", lineId);

참고

Since

version	desc
7.3.1.32