チャート： 凡例 (Chart legend)

判例の設定について説明します。

凡例については Graph、LegendArea、LegendText および LegendMarker にて設定を行います。
Graph に定義されている属性の内、以下の項目が凡例に関係します。

• autoLayout (AL_NEVER | AL_AS_NEEDED | AL_ALWAYS)
• egendScrollbarPresence (SP_NEVER | SP_AS_NEEDED | SP_ALWAYS)
• egendSeriesCount CDATA
• legendSeriesStart CDATA

LagendArea には以下の項目が定義されています。

• visible (true | false)
• alongGraphEdge (true | false)
• automaticPlacement (AP_NEVER | AP_ALWAYS)
• position (LAP_TOP | LAP_BOTTOM | LAP_RIGHT | LAP_LEFT)
• threeDSurfacePosition (LAP_TOP | LAP_BOTTOM | LAP_RIGHT | LAP_LEFT)
• borderColor
• fillColor
• borderTransparent (true | false)
• fillTransparent (true | false)
• markersPerRowAutomatic (true | false)
• legendMarkersPerRow
• legendTextPosition (LTP_ON_RIGHT | LTP_ON_LEFT | LTP_BELOW | LTP_ABOVE | LTP_ON_MARKER)
• legendOrientation (LO_AUTOMATIC | LO_HORIZONTAL | LO_VERTICAL)

LegendText には以下の項目が定義されています。

• textFittingAutomatic (true | false)
• fontSizeAbsolute (true | false)
• horizontalAlignment (LEFT | CENTER | RIGHT)
• maxAutoFontSize
• minAutoFontSize
• wordWrapEnabled (true | false)

主な項目について、以下にサンプルで説明します。


【判例の位置】
以下の例では判例をグラフ下に配置し、表示間隔を十分に確保するため、alongGraphEdge を設定します。
<LegendArea visible="true" position="LAP_BOTTOM" alongGraphEdge="true"/>

【判例の位置】
以下の例では判例をグラフ左に配置し、境界線を描画します。また、凡例の表示項目数を3つに制限しています。
<Graph seriesEffect="SE_AUTO_GRADIENT" graphType="BAR_VERT_STACK" legendSeriesCount="3">
<LegendArea visible="true" position="LAP_LEFT" borderTransparent="false" borderColor="#ccccff" />

【判例のマーカーサイズ】
判例のマーカーのサイズはLegendMarkerで設定できます。
<LegendMarker size="2" />

---

[ Summary ]
Set Graph, LegendArea, LegendText and LegendMarker to configure the legend.
In the first example, the legend is placed at bottom. To get enough space to display the elements, alongGraphEdge is set true.
In the second figure, it shows how to limit the number of elements to display.  The legend is placed on the left side.
The third figure, the legend marker is smaller than ordinary size.