Personnaliser l'étiquette des données du graphique
Ce didacticiel explique comment ajouter et personnaliser des étiquettes de données dans un graphique à l’aide d’Aspose.Words for .NET. Les étiquettes de données fournissent des informations supplémentaires sur les points de données d’un graphique.
Conditions préalables
Pour suivre ce tutoriel, vous devez disposer des éléments suivants :
- Bibliothèque Aspose.Words pour .NET installée.
- Connaissance de base de C# et du traitement de mots avec des documents Word.
Étape 1 : configurer le répertoire de documents
Commencez par configurer le chemin d’accès à votre répertoire de documents. Remplacer"YOUR DOCUMENT DIRECTORY" avec le chemin réel du répertoire dans lequel vous souhaitez enregistrer le document.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Étape 2 : Créer un nouveau document et DocumentBuilder
Créez une nouvelle instance duDocument classe et unDocumentBuilder s’opposer à travailler avec le document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Étape 3 : Insérer et configurer un graphique
Insérez un graphique dans le document à l’aide duInsertChart méthode duDocumentBuilder objet. Définissez le type de graphique et les dimensions souhaités.
Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;
Étape 4 : Personnaliser les étiquettes de données
Accédez à la collection d’étiquettes de données de la série de graphiques et modifiez diverses propriétés pour personnaliser l’apparence des étiquettes de données.
ChartSeries series0 = shape.Chart.Series[0];
ChartDataLabelCollection labels = series0.DataLabels;
labels.ShowLegendKey = true;
labels.ShowLeaderLines = true;
labels.ShowCategoryName = false;
labels.ShowPercentage = false;
labels.ShowSeriesName = true;
labels.ShowValue = true;
labels.Separator = "/";
Étape 5 : Enregistrez le document
Enregistrez le document dans le répertoire spécifié à l’aide duSave méthode. Fournissez le nom de fichier souhaité avec l’extension de fichier appropriée. Dans cet exemple, nous enregistrons le document sous le nom « WorkingWithCharts.ChartDataLabel.docx ».
doc.Save(dataDir + "WorkingWithCharts.ChartDataLabel.docx");
Exemple de code source pour l’étiquette de données de graphique utilisant Aspose.Words pour .NET
// Chemin d'accès à votre répertoire de documents
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;
ChartSeries series0 = shape.Chart.Series[0];
ChartDataLabelCollection labels = series0.DataLabels;
labels.ShowLegendKey = true;
// Par défaut, lorsque vous ajoutez des étiquettes de données aux points de données dans un graphique à secteurs, des lignes de repère s'affichent pour les étiquettes de données qui sont
// positionné bien en dehors de la fin des points de données. Les lignes de repère créent une connexion visuelle entre une étiquette de données et son
// point de données correspondant.
labels.ShowLeaderLines = true;
labels.ShowCategoryName = false;
labels.ShowPercentage = false;
labels.ShowSeriesName = true;
labels.ShowValue = true;
labels.Separator = "/";
labels.ShowValue = true;
doc.Save(dataDir + "WorkingWithCharts.ChartDataLabel.docx");
C’est ça! Vous avez ajouté et personnalisé avec succès des étiquettes de données dans un graphique à l’aide d’Aspose.Words pour .NET.
Conclusion
Dans ce didacticiel, vous avez appris à ajouter et à personnaliser des étiquettes de données dans un graphique à l’aide d’Aspose.Words for .NET. En suivant le guide étape par étape, vous pouvez insérer un graphique, accéder à la collection d’étiquettes de données et modifier les propriétés pour personnaliser l’apparence des étiquettes de données. Aspose.Words for .NET fournit une API puissante pour le traitement de mots avec des documents et des graphiques Word, vous permettant de créer des graphiques visuellement attrayants et informatifs avec des étiquettes de données personnalisées.
FAQ
T1. Que sont les étiquettes de données dans un graphique ?
Les étiquettes de données dans un graphique fournissent des informations supplémentaires sur les points de données représentés dans le graphique. Ils peuvent afficher des valeurs, des catégories, des noms de séries, des pourcentages ou d’autres détails pertinents en fonction du type de graphique et de la configuration.
Q2. Puis-je personnaliser l’apparence des étiquettes de données ?
Oui, vous pouvez personnaliser l’apparence des étiquettes de données dans un graphique. Aspose.Words for .NET fournit des options pour modifier diverses propriétés des étiquettes de données, telles que l’affichage des clés de légende, des lignes de repère, des noms de catégories, des noms de séries, des valeurs, etc. Vous pouvez également définir des séparateurs et formater les étiquettes pour répondre à vos besoins spécifiques.
Q3. Puis-je ajouter des étiquettes de données à n’importe quel type de graphique ?
Oui, vous pouvez ajouter des étiquettes de données à différents types de graphiques, notamment des graphiques à barres, des diagrammes circulaires, des graphiques linéaires, etc. Le processus d’ajout et de personnalisation des étiquettes de données peut varier légèrement en fonction du type de graphique et de la bibliothèque ou de l’outil que vous utilisez.
