Définir les options par défaut pour les étiquettes de données dans un graphique

Introduction

Bonjour ! Vous avez hâte de vous lancer dans le monde de l’automatisation des documents ? Aujourd’hui, nous allons découvrir comment utiliser Aspose.Words pour .NET pour créer de superbes documents par programmation. Aspose.Words est une bibliothèque puissante qui vous permet de manipuler facilement des documents Word. Dans ce didacticiel, nous nous concentrerons sur la définition des options par défaut pour les étiquettes de données dans un graphique. Que vous soyez un développeur chevronné ou un débutant, ce guide vous guidera à travers chaque étape pour vous permettre d’être opérationnel en un rien de temps.

Prérequis

Avant de commencer, assurez-vous que vous disposez de tout ce dont vous avez besoin pour suivre ce tutoriel. Voici une liste de contrôle rapide :

Visual Studio ou tout autre IDE compatible .NET : c’est ici que vous écrirez et exécuterez votre code.
Aspose.Words pour .NET : vous pouveztélécharger la dernière version et installez-le dans votre projet.
Connaissances de base de la programmation C# : bien que ce guide soit adapté aux débutants, une petite familiarité avec C# sera utile.
.NET Framework installé : assurez-vous que .NET Framework est configuré sur votre ordinateur.
Une licence temporaire pour Aspose.Words : obtenez-en uneici pour déverrouiller toutes les fonctionnalités.

Une fois ces prérequis réglés, nous sommes prêts à démarrer !

Importer des espaces de noms

Tout d’abord, configurons notre projet et importons les espaces de noms nécessaires. Ces espaces de noms sont essentiels pour accéder à la fonctionnalité Aspose.Words.

using System;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.ReportingServices;

Étape 1 : Créer un nouveau document

Le voyage commence par la création d’un nouveau document et l’initialisation d’unDocumentBuilder . LeDocumentBuilder La classe fournit un ensemble de méthodes permettant de manipuler facilement le contenu du document.

// Chemin vers votre répertoire de documents
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Créer un nouveau document
Document doc = new Document();

// Initialiser DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);

Explication

Dans cette étape, nous avons configuré le document et le générateur que nous utiliserons pour insérer et formater notre contenu.dataDir la variable contient le chemin où nous enregistrerons notre document final.

Étape 2 : Insérer un graphique

Ensuite, nous allons ajouter un graphique à secteurs à notre document.InsertChart méthode de laDocumentBuilder la classe rend cela super facile.

// Insérer un graphique à secteurs
Shape shape = builder.InsertChart(ChartType.Pie, 432, 252);

// Accéder à l'objet graphique
Chart chart = shape.Chart;

Explication

Ici, nous insérons un graphique à secteurs dans notre document.InsertChart La méthode requiert le type de graphique, la largeur et la hauteur comme paramètres. Après avoir inséré le graphique, nous accédons à l’objet graphique pour le manipuler davantage.

Étape 3 : Personnaliser la série de graphiques

Nous allons maintenant effacer toutes les séries existantes dans le graphique et ajouter notre série personnalisée. Cette série représentera nos points de données.

// Effacer les séries de graphiques existantes
chart.Series.Clear();

// Ajouter une nouvelle série au graphique
ChartSeries series = chart.Series.Add("Aspose Series 1",
    new string[] { "Category 1", "Category 2", "Category 3" },
    new double[] { 2.7, 3.2, 0.8 });

Explication

Dans cette étape, nous nous assurons que notre graphique est vide en supprimant toutes les séries préexistantes. Ensuite, nous ajoutons une nouvelle série avec des catégories et des valeurs personnalisées, qui seront affichées dans notre graphique à secteurs.

Étape 4 : définir les options par défaut pour les étiquettes de données

Les étiquettes de données sont essentielles pour rendre votre graphique informatif. Nous allons définir des options pour afficher le pourcentage, la valeur et personnaliser le séparateur.

// Accéder à la collection d'étiquettes de données
ChartDataLabelCollection labels = series.DataLabels;

// Définir les options d’étiquette de données
labels.ShowPercentage = true;
labels.ShowValue = true;
labels.ShowLeaderLines = false;
labels.Separator = " - ";

Explication

Ici, nous accédons à laDataLabelspropriété de notre série pour personnaliser l’apparence et les informations affichées sur chaque étiquette de données. Nous avons choisi d’afficher à la fois le pourcentage et la valeur, de masquer les lignes de repère et de définir un séparateur personnalisé.

Étape 5 : Enregistrer le document

Enfin, nous allons enregistrer notre document dans le répertoire spécifié. Cette étape garantit que toutes nos modifications sont écrites dans un fichier.

// Enregistrer le document
doc.Save(dataDir + "WorkingWithCharts.DefaultOptionsForDataLabels.docx");

Explication

Dans cette dernière étape, nous sauvegardons notre document en utilisant leSave méthode. Le document sera enregistré dans le répertoire spécifié pardataDir, avec le nom « WorkingWithCharts.DefaultOptionsForDataLabels.docx ».

Conclusion

Et voilà ! Vous avez réussi à créer un document Word avec un graphique à secteurs personnalisé à l’aide d’Aspose.Words pour .NET. Cette puissante bibliothèque facilite l’automatisation de la création et de la manipulation de documents, vous faisant ainsi gagner du temps et des efforts. Que vous génériez des rapports, des factures ou tout autre type de document, Aspose.Words est là pour vous.

N’hésitez pas à explorer leDocumentation Aspose.Words pour plus de fonctionnalités et d’exemples. Bon codage !

FAQ

Puis-je utiliser Aspose.Words gratuitement ?

Vous pouvez utiliser Aspose.Words gratuitement avec unpermis temporaire ou explorez ses fonctionnalités en utilisant leessai gratuit.

Comment puis-je obtenir de l’aide pour Aspose.Words ?

Vous pouvez obtenir de l’aide via leForum d’assistance Aspose.Words.

Puis-je ajouter d’autres types de graphiques ?

Oui, Aspose.Words prend en charge différents types de graphiques tels que les graphiques à barres, à courbes et à colonnes. Vérifiez ledocumentation pour plus de détails.

Aspose.Words est-il compatible avec .NET Core ?

Oui, Aspose.Words est compatible avec .NET Core. Vous trouverez plus d’informations dans ledocumentation.

Comment puis-je acheter une licence pour Aspose.Words ?

Vous pouvez acheter une licence auprès duMagasin Aspose.