グラフのデータラベルの数値をフォーマットする

導入

魅力的で情報豊富なドキュメントを作成するには、適切にフォーマットされたデータラベル付きのグラフを含めることがよく必要になります。Word ドキュメントを洗練されたグラフで強化したいと考えている .NET 開発者にとって、Aspose.Words for .NET はそれを実現するのに役立つ素晴らしいライブラリです。このチュートリアルでは、Aspose.Words for .NET を使用してグラフの数値ラベルをフォーマットするプロセスを段階的に説明します。

前提条件

コードに進む前に、いくつかの前提条件を満たす必要があります。

Aspose.Words for .NET: Aspose.Words for .NETライブラリがインストールされていることを確認してください。まだインストールしていない場合は、ここからダウンロード.
開発環境: .NET 開発環境をセットアップする必要があります。Visual Studio を強くお勧めします。
C# の基礎知識: このチュートリアルでは C# コードの作成と理解が含まれるため、C# プログラミングの知識が必須です。
一時ライセンス: Aspose.Wordsを制限なく使用するには、一時ライセンス.

それでは、グラフ内の数値ラベルをフォーマットする手順を詳しく説明します。

名前空間のインポート

まず最初に、Aspose.Words for .NET を操作するために必要な名前空間をインポートする必要があります。C# ファイルの先頭に次の行を追加します。

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

ステップ1: ドキュメントディレクトリを設定する

Word 文書の操作を開始する前に、文書を保存するディレクトリを指定する必要があります。これは、後で保存操作を行うために不可欠です。

string dataDir = "YOUR DOCUMENT DIRECTORY";

交換する"YOUR DOCUMENT DIRECTORY"ドキュメントディレクトリへの実際のパスを入力します。

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

次のステップは、新しいDocumentそしてDocumentBuilder 。DocumentBuilderドキュメントのコンテンツを構築できるようにするヘルパークラスです。

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

ステップ3: ドキュメントにグラフを挿入する

さて、ドキュメントにグラフを挿入してみましょう。DocumentBuilderこのチュートリアルでは、折れ線グラフを例として使用します。

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
chart.Title.Text = "Data Labels With Different Number Format";

ここでは、特定の幅と高さを持つ折れ線グラフを挿入し、グラフのタイトルを設定します。

ステップ4: デフォルトのシリーズをクリアして新しいシリーズを追加する

デフォルトでは、チャートには事前に生成されたシリーズがいくつか含まれます。これらをクリアし、特定のデータポイントを含む独自のシリーズを追加する必要があります。

//デフォルトで生成されたシリーズを削除します。
chart.Series.Clear();

//カスタム データ ポイントを使用して新しいシリーズを追加します。
ChartSeries series1 = chart.Series.Add("Aspose Series 1", 
	new string[] { "Category 1", "Category 2", "Category 3" }, 
	new double[] { 2.5, 1.5, 3.5 });

ステップ5: データラベルを有効にする

グラフにデータラベルを表示するには、シリーズに対してデータラベルを有効にする必要があります。

series1.HasDataLabels = true;
series1.DataLabels.ShowValue = true;

ステップ6: データラベルの書式設定

このチュートリアルの核となるのは、データラベルの書式設定です。各データラベルに個別に異なる数値書式を適用できます。

series1.DataLabels[0].NumberFormat.FormatCode = "\"$\"#,##0.00"; //通貨形式
series1.DataLabels[1].NumberFormat.FormatCode = "dd/mm/yyyy"; //日付形式
series1.DataLabels[2].NumberFormat.FormatCode = "0.00%"; //パーセンテージ形式

さらに、データラベルの書式をソースセルにリンクすることもできます。リンクすると、NumberFormat一般にリセットされ、ソースセルから継承されます。

series1.DataLabels[2].NumberFormat.IsLinkedToSource = true;

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

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

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

これにより、ドキュメントが指定された名前で保存され、フォーマットされたデータラベルを含むグラフが保持されます。

結論

Aspose.Words for .NET を使用してグラフのデータラベルを書式設定すると、Word 文書の読みやすさと専門性が大幅に向上します。このステップバイステップガイドに従うことで、グラフを作成し、データシリーズを追加し、ニーズに合わせてデータラベルを書式設定できるようになります。Aspose.Words for .NET は、Word 文書の広範なカスタマイズと自動化を可能にする強力なツールであり、.NET 開発者にとって非常に貴重な資産となります。

よくある質問

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

Aspose.Words for .NET は、C# を使用してプログラム的に Word 文書を作成、操作、変換するための強力なライブラリです。

Aspose.Words for .NET を使用して他の種類のグラフをフォーマットできますか?

はい、Aspose.Words for .NET は、棒グラフ、縦棒グラフ、円グラフなど、さまざまな種類のグラフをサポートしています。

Aspose.Words for .NET の一時ライセンスを取得するにはどうすればよいですか?

臨時免許証を取得できますここ.

Excel でデータラベルをソースセルにリンクすることは可能ですか?

はい、データラベルをソースセルにリンクして、数値形式をソースセルから継承することができます。

Aspose.Words for .NET の詳細なドキュメントはどこで入手できますか?

包括的なドキュメントが見つかりますここ.