Obtenir les points de connexion de la forme dans Excel

Introduction

Lorsque vous travaillez avec des fichiers Excel par programmation, nous devons souvent interagir avec des formes intégrées dans les feuilles. L’une des tâches les plus avancées que vous pouvez effectuer consiste à extraire des points de connexion d’une forme. Les points de connexion sont utilisés pour associer des formes à des connecteurs et gérer leur mise en page avec plus de précision. Si vous cherchez à obtenir les points de connexion d’une forme dans Excel, Aspose.Cells pour .NET est l’outil qu’il vous faut. Dans ce didacticiel, nous vous guiderons pas à pas dans la réalisation de cette tâche.

Prérequis

Avant de plonger dans le code, assurez-vous de disposer des prérequis suivants :

• Aspose.Cells pour .NET : vous devez avoir installé Aspose.Cells dans votre environnement de développement. Si vous ne l’avez pas encore, vous pouveztéléchargez la dernière version ici.
• Environnement de développement : assurez-vous que vous disposez d’une installation fonctionnelle de Visual Studio ou de tout autre IDE compatible .NET.
• Connaissances de base de C# : ce didacticiel suppose que vous avez une compréhension de base de la programmation C# et des principes orientés objet. Vous pouvez également vous inscrire à unessai gratuit d’Aspose.Cells si vous ne l’avez pas déjà fait. Cela vous donnera accès à toutes les fonctionnalités requises pour ce guide.

Paquets d’importation

Pour utiliser Aspose.Cells dans votre projet, vous devez inclure les espaces de noms nécessaires. Les instructions d’importation suivantes doivent être placées en haut de votre code :

using System.IO;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using System.Drawing;

Ces espaces de noms vous donnent accès aux fonctionnalités principales d’Aspose.Cells et vous permettent de manipuler des feuilles de calcul et des formes.

Guide étape par étape pour obtenir les points de connexion d’une forme

Dans cette section, nous vous expliquerons comment extraire les points de connexion d’une forme dans une feuille de calcul Excel. Suivez attentivement chaque étape pour une compréhension claire.

Étape 1 : créer un nouveau classeur

Tout d’abord, nous devons créer une instance deWorkbook classe. Ceci représente un fichier Excel dans Aspose.Cells. Si vous n’avez pas de fichier existant, pas de problème : vous pouvez commencer avec un classeur vierge.

// Instancier un nouveau classeur
Workbook workbook = new Workbook();

Dans cette étape, nous avons créé un classeur Excel vide, mais vous pouvez également en charger un existant en transmettant le chemin du fichier à l’Workbook constructeur.

Étape 2 : Accéder à la première feuille de travail

Ensuite, nous devons accéder à la feuille de calcul dans laquelle nous souhaitons travailler avec les formes. Dans ce cas, nous utiliserons la première feuille de calcul du classeur.

// Obtenez la première feuille de travail du classeur
Worksheet worksheet = workbook.Worksheets[0];

Cette ligne permet d’accéder à la première feuille de calcul de la collection de feuilles de calcul du classeur. Si vous travaillez avec une feuille spécifique, vous pouvez remplacer l’index0 avec l’index souhaité.

Étape 3 : Ajouter une nouvelle zone de texte (forme)

Maintenant, ajoutons une nouvelle forme à la feuille de calcul. Nous allons créer une zone de texte, qui est un type de forme. Vous pouvez également ajouter d’autres types de formes, mais pour plus de simplicité, nous nous en tiendrons à une zone de texte dans ce didacticiel.

// Ajouter une nouvelle zone de texte à la collection
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);

Voici ce que nous avons fait :

• Ajout d’une zone de texte à la ligne2 , colonne1.
• Définissez les dimensions de la zone de texte sur160 unités de largeur et200 unités de hauteur.

Étape 4 : Accéder à la forme à partir de la collection de formes

Une fois que nous avons ajouté la zone de texte, elle fait partie de la collection de formes de la feuille de calcul. Nous allons maintenant accéder à cette forme à l’aide de laShapescollection.

// Accéder à la forme (zone de texte) à partir de la collection de formes
Shape shape = workbook.Worksheets[0].Shapes[0];

Dans cette étape, nous récupérons la première forme (notre zone de texte) de la collection. Si vous avez plusieurs formes, vous pouvez spécifier l’index ou même rechercher la forme par son nom.

Étape 5 : Récupérer les points de connexion

Maintenant que nous avons notre forme, extrayons ses points de connexion. Ces points sont utilisés pour attacher des connecteurs à la forme.ConnectionPoints la propriété de la forme renvoie tous les points de connexion disponibles.

// Obtenez tous les points de connexion dans cette forme
var connectionPoints = shape.ConnectionPoints;

Cela nous donne une collection de tous les points de connexion disponibles pour cette forme.

Étape 6 : Afficher les points de connexion

Enfin, nous souhaitons afficher les coordonnées de chaque point de connexion. C’est ici que nous parcourons les points de connexion et les imprimons sur la console.

// Afficher tous les points de forme
foreach (var pt in connectionPoints)
{
    System.Console.WriteLine(string.Format("X = {0}, Y = {1}", pt.X, pt.Y));
}

Cette boucle parcourt chaque point de connexion et imprime leX etY coordonnées. Cela peut être utile pour déboguer ou confirmer visuellement les points de connexion d’une forme.

Étape 7 : Exécuter et terminer

Une fois que vous avez configuré toutes les étapes ci-dessus, vous pouvez exécuter le code. Voici la dernière ligne qui garantit que le processus se termine avec succès :

System.Console.WriteLine("GetShapeConnectionPoints executed successfully.");

Cette ligne enregistre simplement un message sur la console indiquant que le processus est terminé.

Conclusion

Dans ce didacticiel, nous avons expliqué comment récupérer les points de connexion d’une forme dans Excel à l’aide d’Aspose.Cells pour .NET. En divisant la tâche en petites étapes digestes, nous avons exploré le processus de création d’un classeur, d’ajout d’une forme et d’extraction des points de connexion. En comprenant comment manipuler les formes par programmation, vous accédez à un monde de possibilités pour créer des feuilles Excel dynamiques et interactives. Que vous créiez des rapports, des tableaux de bord ou des diagrammes, ces connaissances vous seront utiles.

FAQ

Qu’est-ce qu’un point de connexion dans une forme ?

Un point de connexion est un point spécifique sur une forme où vous pouvez attacher des connecteurs ou le lier à d’autres formes.

Puis-je récupérer les points de connexion pour toutes les formes dans une feuille de calcul ?

Oui, Aspose.Cells vous permet de récupérer des points de connexion pour toute forme qui les prend en charge. Parcourez simplement la collection de formes dans la feuille de calcul.

Ai-je besoin d’une licence pour utiliser Aspose.Cells ?

Oui, bien que vous puissiez l’essayer gratuitement, une licence est requise pour accéder à toutes les fonctionnalités. Vous pouvezacheter une licence iciou obtenir unpermis temporaire.

Comment puis-je ajouter différents types de formes dans Aspose.Cells ?

Vous pouvez utiliser leAdd méthode pour les formes telles que les rectangles, les ellipses, etc. Chaque forme possède des paramètres spécifiques que vous pouvez personnaliser.

Comment charger un fichier Excel existant au lieu d’en créer un nouveau ?

Pour charger un fichier existant, transmettez le chemin du fichier à l’Workbook constructeur, comme ceci :

Workbook workbook = new Workbook("path_to_file.xlsx");