SharpPlot.KeyStyle Property

Set the Key style to any combination of flags.

public KeyStyles KeyStyle {get; set;}

Example

sp.KeyStyle = KeyStyles.Vertical;

Markers are normally included in keys if they are shown on each line – they can be omitted with style ‘plain’. When you use sp.DrawKey to place the key explicitly, the keys are normally positioned relative to the current (x,y) axes (style ‘Relative’) but you can choose to use absolute coordinates here, in which case you give the position of the key in Points from the chart origin (where the Axes would normally cross).

Any of the key layouts may be used with the autofit style. This starts with the type-size you specify and progressively reduces the font until the entire key fits into the available key frame. This may be a useful option if you are generating the key text from descriptions on a database, and hence do not know in advance how much space to allow for the key.

You would often want the ‘reversed’ ordering for stacked barcharts or surface charts. In this case the ‘reversed,vertical’ style means that the boxes in the key match the ordering of the bars or surfaces.

The ‘inline’ style is only used for LineGraphs. It writes the key text immediately to the right of the last point on the line, so is appropriate for timeseries data with well-separated lines. It may be necessary to increase the space in the right margin to make room for long series names.

Options

VerticalVertically arranged legend
ReversedReversed order of legend items
BoxedBoxed key
RoundedRounded key box
ShadowedShadowed key box
BoxFrameBox given frame instead of text
AutofitTextShrink text to fit within given frame
PercentagePercentage of chart area used for placement
AbsolutePositionAbsolute position in points is given
PlainPlain (no markers) key
NoKeyNo key (always omit key)
InlineWithDataLegends are written inline with data
LeftAlignLeft aligned key frame
CenterAlignCenter aligned key frame
RightAlignRight aligned key frame
TopAlignTop aligned key frame
MiddleAlignMiddle aligned key frame
BottomAlignBottom aligned key frame

See also ...

SharpPlot Members | DrawKey Method | SetKeyFrame Method