Contrôles dans les graphiques
Ajout de contrôle d’étiquette au graphique
Les étiquettes fournissent un moyen de fournir des informations aux utilisateurs sur le contenu d’une feuille de calcul. Aspose.Cells vous permet d’ajouter et de manipuler des étiquettes même dans les graphiques.
La classe ShapeCollection fournit une méthode nommée addLabelInChart, utilisée pour ajouter un contrôle d’étiquette à un graphique. Ci-dessous se trouve une liste des paramètres utilisés pour la méthode:
- haut – le décalage vertical de l’étiquette depuis le coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- gauche – le décalage horizontal de l’étiquette depuis le coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- hauteur – la hauteur de l’étiquette, en unités de 1/4000 de la zone du graphique.
- largeur – la largeur de l’étiquette, en unités de 1/4000 de la zone du graphique.
La méthode retourne un objet de la classe Label, où la classe Label représente une étiquette dans le graphique. Elle possède des membres importants détaillés ci-dessous :
- La propriété Text spécifie une chaîne de légende d’étiquette.
- La propriété Fill spécifie les attributs de couleur de remplissage.
L’exemple suivant montre comment ajouter une étiquette au graphique. L’exemple utilise un fichier de concepteur qui contient un graphique. Nous utilisons ce fichier pour insérer une étiquette dans le graphique.
Ci-dessous, une capture d’écran du fichier de concepteur.
Le graphique du designer
Ci-dessous se trouve le code original pour ajouter une étiquette au graphique. La sortie suivante est générée lors de l’exécution du code.
Une étiquette est ajoutée dans le graphique
Ajout d’un contrôle TextBox au graphique
Une manière de mettre en évidence des informations importantes dans un rapport est d’utiliser une zone de texte. Par exemple, saisissez du texte pour mettre en valeur le nom de l’entreprise ou pour indiquer la région géographique avec le plus de ventes. La classe ShapeCollection fournit une méthode appelée addTextBoxInChart, qui est utilisée pour ajouter un contrôle de zone de texte à un graphique. Voici la liste des paramètres utilisés pour la méthode :
- top - le décalage vertical de la zone de texte depuis le coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- gauche – le décalage vertical de la zone de texte du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- height - la hauteur de la zone de texte, en unités de 1/4000 de la zone du graphique.
- width - la largeur de la zone de texte, en unités de 1/4000 de la zone du graphique.
La méthode renvoie un objet de la classe TextBox où la classe TextBox représente une zone de texte dans le graphique.
L’exemple suivant montre comment ajouter une zone de texte à un graphique. L’exemple utilise le fichier de conception précédent qui contient un graphique. Nous utilisons ce fichier pour insérer une zone de texte dans le graphique afin d’afficher le titre du graphique.
Ci-dessous se trouve le code original pour ajouter une zone de texte au graphique. La sortie suivante est générée lors de l’exécution du code.
Une zone de texte est ajoutée dans le graphique
Ajout d’une image au graphique
Aspose.Cells vous permet d’insérer des images dans un graphique. Par exemple, ajoutez une image pour mettre en avant ou donner plus de sens à un graphique ou à son contenu, ou insérez un fichier image de marque.
La classe ShapeCollection fournit une méthode nommée addPictureInChart, qui est utilisée pour ajouter un objet image au graphique. Voici la liste des paramètres utilisés pour la méthode :
- top - le décalage vertical de l’image depuis le coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- left - le décalage vertical de l’image depuis le coin supérieur gauche en unités de 1/4000 de la zone du graphique.
- stream - un objet flux qui contient les données de l’image.
- widthScale - l’échelle de la largeur de l’image, une valeur en pourcentage.
- heightScale - l’échelle de la hauteur de l’image, une valeur en pourcentage.
La méthode renvoie un objet de la classe Picture où la classe Picture représente un objet image dans le graphique.
L’exemple suivant montre comment ajouter une image au graphique. L’exemple utilise le fichier de conception précédent qui contient un graphique. Nous utilisons ce fichier pour insérer une image dans le graphique.
Ci-dessous se trouve le code original pour ajouter une image au graphique. La sortie suivante est générée lors de l’exécution du code
Une image est insérée dans le graphique
Ajout d’une case à cocher dans le graphique
Aspose.Cells vous permet d’insérer des cases à cocher dans une feuille de graphique en utilisant l’énumération MsoDrawingType. L’exemple suivant démontre l’ajout d’une case à cocher à une feuille de graphique.
L’image suivante montre la feuille de graphique avec la case à cocher dans le fichier de sortie.
Le fichier de sortie généré par le code suivant est joint à titre indicatif.