グラフデータラベルをカスタマイズする

導入

動的でカスタマイズされたドキュメント処理機能を使用して .NET アプリケーションを改良したいとお考えですか? Aspose.Words for .NET がまさにその答えかもしれません! このガイドでは、Word ドキュメントを作成、変更、変換するための強力なライブラリである Aspose.Words for .NET を使用して、グラフのデータラベルをカスタマイズする方法について詳しく説明します。熟練した開発者でも、初心者でも、このチュートリアルでは各ステップを順を追って説明し、このツールを効果的に活用する方法を理解できるようにします。

前提条件

始める前に、以下のものを用意してください。

Visual Studio: Visual Studio 2019 以降をインストールします。
.NET Framework: .NET Framework 4.0 以降がインストールされていることを確認してください。
Aspose.Words for .NET: Aspose.Words for .NETを以下のサイトからダウンロードしてインストールします。ダウンロードリンク.
C# の基礎知識: C# プログラミングに精通していることが必須です。
有効なライセンス:一時ライセンスまたは、購入リンク.

名前空間のインポート

まず、必要な名前空間を C# プロジェクトにインポートする必要があります。この手順は、Aspose.Words によって提供されるすべてのクラスとメソッドにアクセスできるようにするため、非常に重要です。

using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Saving;
using Aspose.Words.Charts;

ステップ 1: ドキュメントと DocumentBuilder を初期化する

Word文書を作成して操作するには、まずインスタンスを初期化する必要があります。DocumentクラスとDocumentBuilder物体。

//ドキュメントディレクトリへのパス
string dataDir = "YOUR DOCUMENT DIRECTORY";

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

説明

Document doc: Document クラスの新しいインスタンスを作成します。
DocumentBuilder ビルダー: DocumentBuilder は、Document オブジェクトにコンテンツを挿入するのに役立ちます。

ステップ2: グラフを挿入する

次に、棒グラフをドキュメントに挿入します。DocumentBuilder物体。

Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;

説明

図形: ドキュメント内の図形としてグラフを表します。
builder.InsertChart(ChartType.Bar, 432, 252): 指定された寸法の棒グラフを挿入します。

ステップ3: チャートシリーズにアクセスする

データラベルをカスタマイズするには、まずグラフ内のシリーズにアクセスする必要があります。

ChartSeries series0 = shape.Chart.Series[0];

説明

ChartSeries series0: カスタマイズするグラフの最初のシリーズを取得します。

ステップ4: データラベルをカスタマイズする

データラベルは、さまざまな情報を表示するようにカスタマイズできます。凡例キー、シリーズ名、値を表示し、カテゴリ名とパーセンテージを非表示にするようにラベルを構成します。

ChartDataLabelCollection labels = series0.DataLabels;
labels.ShowLegendKey = true;
labels.ShowLeaderLines = true;
labels.ShowCategoryName = false;
labels.ShowPercentage = false;
labels.ShowSeriesName = true;
labels.ShowValue = true;
labels.Separator = "/";

説明

ChartDataLabelCollection ラベル: 系列のデータラベルにアクセスします。
labels.ShowLegendKey: 凡例キーを表示します。
labels.ShowLeaderLines: データポイントの外側に配置されたデータラベルのリーダーラインを表示します。
labels.ShowCategoryName: カテゴリ名を非表示にします。
labels.ShowPercentage: パーセンテージ値を非表示にします。
labels.ShowSeriesName: シリーズ名を表示します。
labels.ShowValue: データポイントの値を表示します。
labels.Separator: データラベルの区切り文字を設定します。

ステップ5: ドキュメントを保存する

最後に、ドキュメントを指定されたディレクトリに保存します。

doc.Save(dataDir + "WorkingWithCharts.ChartDataLabel.docx");

説明

doc.Save: 指定された名前でドキュメントを指定されたディレクトリに保存します。

結論

おめでとうございます！Aspose.Words for .NETを使用してグラフのデータラベルをカスタマイズできました。このライブラリは、Word文書をプログラムで処理するための堅牢なソリューションを提供し、開発者が高度で動的な文書処理アプリケーションを簡単に作成できるようにします。ドキュメンテーションさらに多くの機能と能力を探索します。

よくある質問

Aspose.Words for .NET とは何ですか?

Aspose.Words for .NET は、開発者がプログラムによって Word ドキュメントを作成、変更、変換できるようにする強力なドキュメント処理ライブラリです。

Aspose.Words for .NET をインストールするにはどうすればよいですか?

ダウンロードしてインストールするには、ダウンロードリンク提供されているインストール手順に従ってください。

Aspose.Words for .NET を無料で試すことはできますか?

はい、無料トライアルまたは一時ライセンス製品を評価するため。

Aspose.Words for .NET は .NET Core と互換性がありますか?

はい、Aspose.Words for .NET は .NET Core、.NET Standard、.NET Framework と互換性があります。

Aspose.Words for .NET のサポートはどこで受けられますか?

訪問することができますサポートフォーラム Aspose コミュニティと専門家からのヘルプとサポートを受けられます。