Reference > Properties > KeyStyle Property

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

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

See also ...

SharpPlot Members | DrawKey Method | SetKeyFrame Method


Send comments on this topic
© Dyalog Ltd 2013