Travailler avec les graphiques
La nouvelle insertChart la méthode a été ajoutée à la DocumentBuilder En cours. Donc, voyons comment insérer un simple diagramme de colonnes dans le document en utilisant insérer Graphique méthode.
Comment insérer un graphique depuis Scratch en utilisant Aspose.Words
Dans cette section, nous apprendrons comment insérer un graphique dans un document.
Insérer le tableau des colonnes
L’exemple de code suivant montre comment insérer un tableau de colonnes:
Le code produit le résultat suivant:
Il y a quatre surcharges différentes pour la série Ajouter une méthode qui a été exposée pour couvrir toutes les variantes possibles des sources de données pour tous les types de cartes:
Le code produit le résultat suivant:
Insérer Scatter Graphique
L’exemple de code suivant montre comment insérer un graphique de dispersion:
Le code produit le résultat suivant:
Insérer une zone Graphique
L’exemple de code suivant montre comment insérer un graphique régional:
Le code produit le résultat suivant:
Insérer le graphique des bulles
L’exemple de code suivant montre comment insérer un graphique à bulles:
Le code produit le résultat suivant:
Travailler avec les graphiques à travers Shape.Chart Objet
Une fois le graphique inséré et rempli de données, vous pouvez changer son apparence. Shape.Chart propriété contient toutes les options liées au graphique disponibles par l’intermédiaire du public API.
Par exemple, changeons Titre du graphique ou comportement de la légende:
Le code génère les résultats suivants:
Comment travailler avec ChartSeriesCollection de Chart
Laissez voir ChartSeries recouvrement. Toutes les séries de graphiques sont disponibles dans le chart.getSeries() la collecte, qui est Iterable:
Vous pouvez supprimer la série un par un ou effacer tous les ainsi que d’ajouter un nouveau si nécessaire. Le graphique nouvellement inséré a quelques séries par défaut ajoutées à cette collection. Pour les supprimer, vous devez appeler le chart.getSeries().clear() méthode.
Travailler avec une seule classe de séries graphiques
Voici comment travailler avec une série particulière.
Veuillez consulter le résultat ci-dessous:
Tous simples ChartSeries ont par défaut ChartDataPoint options, veuillez essayer en utilisant le code suivant pour les modifier:
Comment travailler avec un seul graphiqueDataPoint d’un ChartSeries
Utilisation ChartDataPoint vous pouvez personnaliser le formatage d’un seul point de données de la série de cartes:
Veuillez consulter le résultat ci-dessous:
Comment travailler avec ChartDataLabel d’une série de cartes uniques
Utilisation ChartDataLabel vous êtes en mesure de spécifier le formatage d’une seule étiquette de données de la série de graphiques, comme show/hid LegendKey, CategoryName, SeriesName, Valeur, etc.:
Veuillez consulter le résultat ci-dessous:
Comment définir les options par défaut pour ChartDataLabels de ChartSeries
Les ChartDataLabelCollection class définit les propriétés qui peuvent être utilisées pour définir les options par défaut pour ChartDataLabels pour le graphique Series. Ces propriétés incluent setShowCategoryName, setShowBubbleSize, setShowPourcentage, setSeriesName, setShow Valeur, etc.:
Veuillez consulter le résultat ci-dessous:
Comment formater le nombre d’étiquettes de données graphiques
Utilisation NumberFormat propriété, vous pouvez spécifier le formatage numéro d’une seule étiquette de données du graphique.
L’exemple de code suivant montre comment formater un certain nombre d’étiquettes de données:
Comment définir les propriétés du graphique Axis
Si vous voulez travailler avec l’axe des cartes, l’échelle et les unités d’affichage pour l’axe des valeurs, veuillez utiliser ChartAxis, AxisDisplayUnit, et AxisScaling les cours.
L’exemple de code suivant montre comment définir les propriétés des axes X et Y:
Comment définir DateValeur temporelle de l’axe
L’exemple de code suivant montre comment définir les valeurs date/heure pour les propriétés de l’axe:
Comment formater la valeur numérique de l’axe
L’exemple de code suivant montre comment modifier le format des nombres sur l’axe des valeurs:
Comment définir les limites de l’axe
Les AxisBound classe représente une limite minimale ou maximale des valeurs de l’axe. Bound peut être spécifié comme une valeur numérique, date-heure ou spéciale “auto”.
L’exemple de code suivant montre comment définir les limites d’un axe:
Comment définir l’unité d’intervalle entre les étiquettes
L’exemple de code suivant montre comment régler l’unité d’intervalle entre les étiquettes sur un axe:
Comment cacher l’axe des cartes
Si vous voulez afficher ou masquer l’axe du graphique, vous pouvez simplement atteindre ceci en définissant la valeur de ChartAxis.Hidden propriété.
L’exemple de code suivant montre comment masquer l’axe Y du graphique:
Comment aligner l’étiquette des cartes
Si vous voulez définir un alignement de texte pour les étiquettes multilignes, vous pouvez simplement y arriver en définissant la valeur de setTickLabelAlignment() propriété.
L’exemple de code suivant montre comment cocher l’alignement de l’étiquette:
Comment définir le formatage de remplissage et d’attaque
Le formatage de remplissage et de course peut être défini pour les séries de cartes, les points de données et les marqueurs. Pour cela, vous devez utiliser les propriétés de la ChartFormat type dans les classes ChartSeries, ChartDataPoint et ChartMarker, ainsi que des alias pour certaines propriétés, comme ForeColor, BackColor, Visible, et Transparence dans le Stroke En cours.
L’exemple de code suivant montre comment définir la couleur de la série:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save("ColumnColor.docx");
L’exemple de code suivant montre comment définir la couleur et le poids de la ligne:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save("LineColorAndWeight.docx");