Obtenir les limites des objets dessinés avec Aspose.Cells

Introduction

Êtes-vous prêt à plonger dans le monde de la création, de la manipulation et de l’extraction d’informations à partir de feuilles de calcul Excel à l’aide d’Aspose.Cells pour .NET ? Dans le didacticiel d’aujourd’hui, nous verrons comment dépasser les limites du dessin d’objets dans un fichier Excel en utilisant les fonctionnalités d’Aspose.Cells. Que vous soyez un développeur cherchant à améliorer vos applications avec des fonctionnalités liées à Excel ou simplement désireux d’acquérir une nouvelle compétence, vous êtes au bon endroit !

Prérequis

Avant de nous lancer dans le codage, vous devez maîtriser quelques prérequis :

1. Visual Studio : assurez-vous que Visual Studio est installé sur votre ordinateur. Vous pouvez utiliser la version de votre choix.
2. Aspose.Cells pour .NET : téléchargez et installez Aspose.Cells à partir dulien de téléchargement . Un essai gratuit est également disponibleici.
3. Connaissances de base de C# : une connaissance de la programmation C# sera bénéfique. Si vous êtes nouveau, ne vous inquiétez pas ! Nous vous guiderons à chaque étape.

Une fois votre environnement configuré, nous passerons aux packages nécessaires.

Paquets d’importation

Avant d’utiliser les classes fournies par Aspose.Cells, vous devez importer les espaces de noms nécessaires dans votre projet C#. Voici comment procéder :

1. Ouvrez votre projet Visual Studio.
2. En haut de votre fichier C#, ajoutez les directives using suivantes :

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Aspose.Cells.Rendering;

Avec les packages importés, vous êtes désormais entièrement équipé pour commencer à travailler avec des fichiers Excel.

Décomposons cela en étapes faciles à gérer. Nous allons créer une classe qui capture les limites de l’objet de dessin et les imprime dans une application console.

Étape 1 : créer une classe de gestionnaire d’événements d’objet de dessin

Tout d’abord, vous devez créer une classe qui étend leDrawObjectEventHandler. Cette classe gérera les événements de dessin et vous permettra d’extraire les coordonnées de l’objet.

class clsDrawObjectEventHandler : DrawObjectEventHandler
{
    public override void Draw(DrawObject drawObject, float x, float y, float width, float height)
    {
        Console.WriteLine("");

        //Imprimer les coordonnées et la valeur de l'objet Cell
        if (drawObject.Type == DrawObjectEnum.Cell)
        {
            Console.WriteLine("[X]: " + x + " [Y]: " + y + " [Width]: " + width + " [Height]: " + height + " [Cell Value]: " + drawObject.Cell.StringValue);
        }

        // Imprimer les coordonnées et le nom de la forme de l'objet Image
        if (drawObject.Type == DrawObjectEnum.Image)
        {
            Console.WriteLine("[X]: " + x + " [Y]: " + y + " [Width]: " + width + " [Height]: " + height + " [Shape Name]: " + drawObject.Shape.Name);
        }

        Console.WriteLine("----------------------");
    }
}

• Dans cette classe, nous remplaçons leDraw méthode, qui est appelée chaque fois qu’un objet de dessin est rencontré.
• Nous vérifions le type deDrawObject . Si c’est unCell , nous enregistrons sa position et sa valeur. S’il s’agit d’unImage, nous enregistrons sa position et son nom.

Étape 2 : définir les répertoires d’entrée et de sortie

Ensuite, vous devez spécifier où se trouve votre document Excel et où enregistrer le PDF de sortie.

// Répertoire des sources
string sourceDir = "Your Document Directory";

// Répertoire de sortie
string outputDir = "Your Document Directory";

• Remplacer"Your Document Directory" avec le chemin d’accès à votre document actuel. Assurez-vous d’avoir un exemple de fichier Excel nommé"sampleGetDrawObjectAndBoundUsingDrawObjectEventHandler.xlsx" stocké dans ce répertoire.

Étape 3 : charger le fichier Excel d’exemple

Avec les répertoires définis, nous pouvons maintenant charger le fichier Excel dans une instance duWorkbook classe.

// Charger un exemple de fichier Excel
Workbook wb = new Workbook(sourceDir + "sampleGetDrawObjectAndBoundUsingDrawObjectEventHandler.xlsx");

• Ce code initialise une instance de classeur avec votre exemple de fichier Excel.

Étape 4 : Spécifier les options d’enregistrement PDF

Maintenant que notre classeur est chargé, nous devons définir comment nous souhaitons enregistrer notre sortie sous forme de fichier PDF.

// Spécifier les options d'enregistrement du PDF
PdfSaveOptions opts = new PdfSaveOptions();

Étape 5 : Affecter le gestionnaire d’événements

Il est crucial d’attribuer leDrawObjectEventHandler exemple à nos options d’enregistrement PDF. Cette étape garantira que notre gestionnaire d’événements personnalisé traite chaque objet de dessin.

// Affecter l'instance de la classe DrawObjectEventHandler
opts.DrawObjectEventHandler = new clsDrawObjectEventHandler();

Étape 6 : Enregistrer le classeur au format PDF

Enfin, il est temps d’enregistrer notre classeur au format PDF et d’exécuter l’opération.

// Enregistrer au format PDF avec les options d'enregistrement PDF
wb.Save(outputDir + "outputGetDrawObjectAndBoundUsingDrawObjectEventHandler.pdf", opts);

• Ce code enregistre le classeur sous forme de fichier PDF dans le répertoire de sortie spécifié, en appliquant nos options d’enregistrement pour garantir que nos objets de dessin sont traités.

Étape 7 : Afficher le message de réussite

Enfin et surtout, nous afficherons un message de réussite sur la console une fois l’opération terminée.

Console.WriteLine("GetDrawObjectAndBoundUsingDrawObjectEventHandler executed successfully.");

Conclusion

Et voilà ! En quelques étapes seulement, vous pouvez dessiner des limites d’objet à partir d’un fichier Excel à l’aide d’Aspose.Cells pour .NET. Que vous créiez un outil de création de rapports, que vous ayez besoin d’automatiser la gestion de documents ou que vous souhaitiez simplement explorer la puissance d’Aspose.Cells, ce guide vous a mis sur la bonne voie.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une bibliothèque puissante conçue pour travailler avec des fichiers Excel dans des applications .NET, permettant de créer, de modifier et de convertir des feuilles de calcul.

Puis-je essayer Aspose.Cells gratuitement ?

Oui ! Vous pouvez télécharger une version d’essai gratuite d’Aspose.Cellsici.

Quels formats de fichiers Aspose.Cells prend-il en charge ?

Aspose.Cells prend en charge divers formats, notamment XLSX, XLS, CSV, PDF, etc.

Où puis-je trouver plus d’exemples d’utilisation d’Aspose.Cells ?

Vous pouvez explorer plus d’exemples et une documentation détaillée sur leur site à l’adresseDocumentation sur Aspose.Cells.

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

Pour obtenir de l’aide, visitez leForum Asposeoù vous pouvez poser des questions et obtenir de l’aide de la communauté.