エラーバー

エラーバーの追加

Aspose.Slides for .NET はエラーバーの値を管理するためのシンプルな API を提供します。サンプルコードはカスタム値タイプを使用する場合に適用されます。値を指定するには、シリーズの DataPoints コレクション内の特定のデータポイントの ErrorBarCustomValues プロパティを使用します：

Presentation クラスのインスタンスを作成します。
任意のスライドにバブルチャートを追加します。
最初のチャート系列にアクセスし、エラーバーの X 形式を設定します。
最初のチャート系列にアクセスし、エラーバーの Y 形式を設定します。
バーの値と書式を設定します。
変更したプレゼンテーションを書き込み、PPTX ファイルとして保存します。

// 空のプレゼンテーションを作成
using (Presentation presentation = new Presentation())
{
    // バブルチャートを作成
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // エラーバーを追加し、書式を設定
    IErrorBarsFormat errBarX = chart.ChartData.Series[0].ErrorBarsXFormat;
    IErrorBarsFormat errBarY = chart.ChartData.Series[0].ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Fixed;
    errBarX.Value = 0.1f;
    errBarY.ValueType = ErrorBarValueType.Percentage;
    errBarY.Value = 5;
    errBarX.Type = ErrorBarType.Plus;
    errBarY.Format.Line.Width = 2;
    errBarX.HasEndCap = true;

    // プレゼンテーションを保存
    presentation.Save("ErrorBars_out.pptx", SaveFormat.Pptx);
}

カスタムエラーバー値の追加

Aspose.Slides for .NET はカスタムエラーバー値を管理するためのシンプルな API を提供します。サンプルコードは IErrorBarsFormat.ValueType プロパティが Custom に等しい場合に適用されます。値を指定するには、シリーズの DataPoints コレクション内の特定のデータポイントの ErrorBarCustomValues プロパティを使用します：

Presentation クラスのインスタンスを作成します。
任意のスライドにバブルチャートを追加します。
最初のチャート系列にアクセスし、エラーバーの X 形式を設定します。
最初のチャート系列にアクセスし、エラーバーの Y 形式を設定します。
チャート系列の個々のデータポイントにアクセスし、個別の系列データポイントのエラーバー値を設定します。
バーの値と書式を設定します。
変更したプレゼンテーションを書き込み、PPTX ファイルとして保存します。

// 空のプレゼンテーションを作成
using (Presentation presentation = new Presentation())
{
    // バブルチャートを作成
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // カスタム エラーバーを追加し、書式を設定
    IChartSeries series = chart.ChartData.Series[0];
    IErrorBarsFormat errBarX = series.ErrorBarsXFormat;
    IErrorBarsFormat errBarY = series.ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Custom;
    errBarY.ValueType = ErrorBarValueType.Custom;

    // チャート系列のデータポイントにアクセスし、個々のポイントのエラーバー値を設定
    IChartDataPointCollection points = series.DataPoints;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXMinusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYMinusValues = DataSourceType.DoubleLiterals;

    // チャート系列のポイントにエラーバーを設定
    for (int i = 0; i < points.Count; i++)
    {
        points[i].ErrorBarsCustomValues.XMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.XPlus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YPlus.AsLiteralDouble = i + 1;
    }

    // プレゼンテーションを保存
    presentation.Save("ErrorBarsCustomValues_out.pptx", SaveFormat.Pptx);
}

FAQ

プレゼンテーションを PDF または画像にエクスポートするとエラーバーはどうなりますか？

エラーバーはチャートの一部としてレンダリングされ、互換性のあるバージョンまたはレンダラを前提として、変換中もチャートの書式設定とともに保持されます。

エラーバーをマーカーやデータラベルと組み合わせることはできますか？

はい。エラーバーは別個の要素であり、マーカーやデータラベルと互換性があります。要素が重なる場合は、書式設定を調整する必要がある場合があります。

API でエラーバーを扱うためのプロパティや列挙体の一覧はどこで確認できますか？

API リファレンスで確認できます：ErrorBarsFormat クラスと、関連列挙体の ErrorBarType および ErrorBarValueType。