本稿について

.NETFramework4.6.2, C#7.3, WinForms環境にて、MSChartからの置き換えを狙って、OxyPlotを使用した際、調査したり困ったりしたポイントのまとめ。
WinForms以外、WPF等にも共通する部分が多いと思う。
使用しているOxyPlotはNuGetで手に入る、2016/09/12公開のもの。

サンプルコード内では、PlotModelオブジェクトをmodel、PlotViewオブジェクトをplotView、Seriesオブジェクトをseriesと表記する。

基本的な事項

チャートの表示を更新したい

model.InvalidatePlot(true);

チャートの拡大縮小や描画範囲の選択をリセットしたい

model.ResetAllAxes();

マウス操作としては、中ボタン(マウスホイール)をダブルクリックする。
https://qiita.com/7of9/items/4b2aee6f161bec39a757

コード中で透明色を指定するにはどうしたらいいか

WhiteやBlackといったように、色を名前指定するにはOxyColorsを用いる。
透明色はOxyColors.Transparentになる。

チャートが実線で囲われているのが気にいらない

model.PlotAreaBoarderThickness = new OxyThickness(0);

Axis

拡大縮小、表示範囲の変更を検知したい

AxisオブジェクトのAxisChanged, TransformChangedイベントを使用する。

現在表示している範囲の最大値、最小値はどのプロパティ？

AxisオブジェクトのAcutalMaximum, ActualMinimumプロパティ。

軸のスケールを対数にしたい

LogarithmicAxisクラスを使用する。

Series

折れ線グラフをスムージングしたい

LineSeriesオブジェクトのSmoothプロパティをtrueに。
http://shikaku-sh.hatenablog.com/entry/oxyplot-simple-usage

チャート中のデータ上のマウスクリックを検知したい

SeriesオブジェクトのMouseDownイベントを使用する。

Tracker (ToolTip)

チャート中のデータを左クリックすると表示される小さなウィンドウ(ToolTip)のことを、OxyPlotではTrackerと呼ぶ。

折れ線グラフ中、配置した点と点の間にTrackerを表示したくない

series.CanTrackerInterpolatePoints = false;

Trackerの表示に左クリックが必要だが、マウスカーソルが重なった時に表示してほしい

var controller = new PlotController();

controller.UnbindMouseDown(OxyMouseButton.Left);
controller.BindMouseEnter(PlotCommands.HoverSnapTrack);

plotView.Controller = controller;

Trackerに表示されるデータの書式を変更したい

SeriesオブジェクトのTrackerFormatStringプロパティを使用する。
http://shikaku-sh.hatenablog.com/entry/oxyplot-simple-usage

Trackerに`Series`や`Axis`の`Title`やX,Yの値以外を表示したい

IDataPointProviderを実装するMyDataPoint型を用意し、SeriesオブジェクトのItemsSourceプロパティにMyDataPointの集合を与える。
すると、TrackerFormatStringプロパティの中で、MyDataPointのプロパティを呼び出せるようになる。

class MyDataPoint : IDataPointerProvider
{
    public double X { get; }
    public double Y { get; }
    public double XY => X * Y;

    public MyDataPoint(double x, double y) { X = x; Y = y; }
    public DataPoint GetDataPoint() => new DataPoint(X, Y);
}

var array = new MyDataPoint[100];
for (int i = 0; i < MyDataPoint.Length; i++)
    array[i] = new MyDataPoint(i, i * i);

seires.ItemsSource = array;
sereis.TrackerFormatString = "X = {X}, Y = {Y}, XY = {XY}";

Trackerの背景色を変更したい

WinForms環境の場合、ShowTrackerメソッド内でBackColor = Color.LightSkyBlueとなっているので、変えられないように思う。
他の環境ならどうにかなるかもね。

Trackerとか要らない。表示したくない

model.TrackerChanged += (sender, e) => plotView.HideTracker();

Annotation

チャート内に(グラフ以外の)線をひきたい。その線に説明用の文字列を配置したい

LineAnnotationクラスを使用する。

`LineAnnotation`の`TextHorizontalAlignment`を変えても線の左側に文字列を配置できない

できないので、文字列配置用のPointAnnotationを併用することにした。

チャート内に四角形で強調された範囲を表示したい。その範囲に説明用の文字列を配置したい

RectangleAnnotationクラスを使用する。
文字列は常に四角形の中央に表示されるので、気にいらなければ、説明用の文字列はPointAnnotationで表示するとよい。

`PointAnnotation`の`TextHorizontalAlignment`,`TextVerticalAlignment`が思ったように動作しない

Left, Bottomで点の右上に、Right, Topで点の左下に文字列が表示される。

その他

チャートの内容を画像として保存したい

PngExporterクラスを使用する。

var exporter = new PngExporter
{
    Width = plotView.Width,
    Height = plotView.Height,
    Background = OxyColors.White,
};
var bitmap = exporter.ExportToBitmap(model);

OxyPlot.Series.XYAxisSeries.GetNearestPointInternalメソッド内でArgumentNullExceptionが発生する

これ
https://github.com/oxyplot/oxyplot/issues/931
3年前にIssueとして登録されているがまだCloseされてないので、未対応なのでは。
これがどうにもならなくて、OxyPlotの使用自体をあきらめた。

[C#] OxyPlot Tips集