Ajouter, récupérer, copier et lire les données de forme Visio

Ajout d’une nouvelle forme dans Visio

Aspose.Diagram for .NET vous permet de manipuler les diagrammes Microsoft Visio de différentes manières. L’une des choses que vous pouvez faire est d’ajouter de nouvelles formes à un diagramme. Aspose.Diagram for .NET vous permet d’ajouter une nouvelle forme à un diagram. La forme ajoutée peut également être personnalisée à l’aide de Aspose.Diagram for .NET.

Cette rubrique décrit comment ajouter une nouvelle forme de rectangle à un diagram.

Utilisez Aspose.Diagram for .NET API pour créer de nouvelles formes, puis ajoutez ces formes à la collection de formes d’un diagram.

Pour ajouter une nouvelle forme :

  1. Trouver la page - Chaque Visio diagram contient une collection de pages. Les développeurs peuvent récupérer la page par ID de page ou nom et stocker la page requise dans lePageobjet de classe.
  2. Ajouter le maître requis d’une forme - Chaque Visio diagram contient une collection de maîtres. Les développeurs peuvent ajouter un maître (par ID ou nom) à partir du fichier de gabarit existant (par chemin direct ou flux de fichier).
  3. Ajouter une forme dans le Visio diagram - Les développeurs peuvent placer une nouvelle forme dans le Visio diagram par index de page (à partir de 0), nom principal, PinX, PinY, hauteur (facultatif) et largeur (facultatif).
  4. Définir les propriétés de la forme - La méthode AddShape de la classe Diagram renvoie l’ID de la forme. Les développeurs peuvent récupérer la forme d’un Visio diagram en utilisant cet ID, puis définir ses propriétés, par exemple la couleur, la position, l’alignement et le texte.

L’entrée diagram

tâche : image_autre_texte

Le diagram avec une forme ajoutée

tâche : image_autre_texte

Ajouter un échantillon de programmation

L’extrait de code ci-dessous montre comment effectuer chaque étape.

Récupération des informations sur la forme

Travailler avec des diagrammesexplique comment créer des diagrammes, ajouter des formes et des connecteurs, puis comment récupérer des informations sur les éléments diagram tels quepages, maîtrise, connecteurs etpolices. Cet article explique comment récupérer des informations sur les formes dans un fichier diagram.

Chaque forme dans un diagram a un ID et un nom. L’ID est important lors de la programmation avec Visio : c’est la principale méthode d’accès à une forme. Chaque forme conserve également des informations sur le maître (pochoir) à partir duquel elle est fabriquée.

UNForme est un objet dans un dessin Visio. La propriété Shapes, exposée par la classe Page, prend en charge une collection d’objets Aspose.Diagram.Shape. La propriété Shapes peut être utilisée pour récupérer des informations sur une forme.

Dans la fenêtre de console ci-dessous, par exemple, vous pouvez voir la sortie d’informations pour un diagram qui contenait quatre formes : deux terminateurs, un processus et un connecteur dynamique. Chacun a un identifiant unique ainsi que le nom de la forme principale (pochoir).

Une fenêtre de console affichant des informations sur la forme
tâche : image_autre_texte
Pour récupérer les informations de la page Visio :
  1. Charge un diagram.
  2. Configure une boucle foreach pour parcourir toutes les formes du diagram.
  3. Affiche les informations sur la forme.

Récupérer l’exemple de programmation

Le morceau de code suivant récupère les informations de forme à partir d’un Visio diagram.

Copier des formes à partir d’un Visio existant

Aspose.Diagram for .NET API permet aux développeurs de copier des formes de la page source Visio vers la nouvelle page Visio diagram. Il prend également en charge la copie de formes de groupe. Cet article décrit comment copier toutes les formes à partir de la page source diagram.

Pour copier des formes, les développeurs doivent également copier les thèmes source PageSheet et source Visio afin de préserver le style de remplissage de la forme et d’autres propriétés de mise en forme.

Cet exemple fonctionne comme suit :

  1. Charger une source Visio.
  2. Initialiser un nouveau Visio
  3. Ajoutez des masters et des thèmes à partir de la source Visio.
  4. Obtenir la page de la source Visio.
  5. Copiez sa feuille de page sur la nouvelle page Visio.
  6. Parcourez les formes de la page source Visio.
  7. Définissez son nouvel identifiant et ajoutez-le à la nouvelle page Visio.
  8. Enregistrez le nouveau Visio dans le stockage local.

Copier l’exemple de programmation

Copier une forme Visio dans une autre instance de forme

La méthode Copy de la classe Shape prend une instance de forme à cloner.

 // import diagram

Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");

Shape newShape = new Shape();

// copy diagram

newShape.Copy(diagram.Pages[0].Shapes[0]);

newShape.ID = 3;

newShape.XForm.PinX.Value = 1;

newShape.XForm.PinY.Value = 1;

Lecture des données de forme Visio

La collection Props exposée par leForme la classe soutient laAspose.Diagram.Prop objet. La propriété peut être utilisée pour lire les données d’une forme (propriétés personnalisées).

Lire toutes les propriétés de forme

Pour identifier les propriétés personnalisées dans Microsoft Visio :

  1. Dans un diagram, cliquez avec le bouton droit sur une forme.
  2. SélectionnerDonnées , alorsDonnées de forme du menu. Toutes les propriétés existantes sont répertoriées dans la boîte de dialogue.
Les données d’une forme, comme dans Microsoft Visio. ** 
tâche : image_autre_texte
Une fenêtre de console affichant la sortie des données de forme. ** 
tâche : image_autre_texte

Lire l’exemple de programmation

Les extraits de code ci-dessous lisent les données de forme (propriétés personnalisées).

Lire une propriété de forme par nom

L’extrait de code ci-dessous lit une propriété de forme par son nom (propriété personnalisée).

Exemple de programmation de lecture par nom

Lire les propriétés héritées de la forme

L’extrait de code ci-dessous lit InheritProps d’une forme.

Ajouter et connecter des formes Visio

Aspose.Diagram for .NET vous permet d’ajouter des formes personnalisées et de les connecter dansdiagrammes que vous créez.

Ajout et connexion de formes

Le code dans les exemples ci-dessous montre comment :

  1. Créez un diagram.
  2. Ajoutez et personnalisez des formes (rectangle, étoile, hexagone).
  3. Connectez les formes d’étoile et d’hexagone au rectangle.
  4. Enregistrez le diagram.

Exemple de programmation d’ajout et de connexion de formes

Utiliser les index de connexion pour connecter des formes

Aspose.Diagram for .NET API permet déjà aux développeurs d’ajouter de nouveaux points de connexion sur la forme, et les développeurs peuvent désormais connecter des formes à l’aide d’index de connexion.

Utiliser les index de connexion pour connecter des formes

Le membre ConnectShapesViaConnectorIndex exposé par lePageLa classe peut être utilisée pour connecter des formes à l’aide d’index de connexion. Le code suivant montre comment connecter des formes :

  1. Initialiser un nouveau dessin.
  2. Placez quatre formes rectangulaires
  3. Ajoutez deux points de connexion supplémentaires, de sorte qu’il y aurait trois points de connexion sur la ligne de bordure inférieure
  4. Connectez la première forme de chaque connexion inférieure aux trois autres formes rectangulaires du haut avec des connecteurs dynamiques
  5. Enregistrer le dessin

Utiliser des index de connexion pour connecter des formes Exemple de programmation

Utilisez le code suivant dans votre application .NET pour connecter des formes à l’aide d’index de connexion avec Aspose.Diagram for .NET API.

C#

 // initialize a new drawing

Diagram diagram = new Diagram();

// get page by index

Aspose.Diagram.Page page = diagram.Pages[0];

// add masters

string connectorMaster = "Dynamic connector", rectangle = "Rectangle";

int pageNumber = 0;

double width = 2, height = 2, pinX = 4.25, pinY = 9.5;

diagram.AddMaster(@"C:\temp\Basic Shapes.vss", rectangle);

diagram.AddMaster(@"C:\temp\Basic Shapes.vss", connectorMaster);

// add shapes

long shape1_ID = diagram.AddShape(4.5, 7, rectangle, pageNumber);

long shape2_ID = diagram.AddShape(2.25, 4.5, rectangle, pageNumber);

long shape3_ID = diagram.AddShape(4.5, 4.5, rectangle, pageNumber);

long shape4_ID = diagram.AddShape(6.75, 4.5, rectangle, pageNumber);

// get shapes by ID

Aspose.Diagram.Shape shape1 = page.Shapes.GetShape(shape1_ID);

Aspose.Diagram.Shape shape2 = page.Shapes.GetShape(shape2_ID);

Aspose.Diagram.Shape shape3 = page.Shapes.GetShape(shape3_ID);

Aspose.Diagram.Shape shape4 = page.Shapes.GetShape(shape4_ID);

// add two more connection points

Connection connection1 = new Connection();

connection1.X.Ufe.F = "Width*0.33";

connection1.Y.Ufe.F = "Height*0";

Connection connection3 = new Connection();

connection3.X.Ufe.F = "Width*0.66";

connection3.Y.Ufe.F = "Height*0";

shape1.Connections.Add(connection1);

shape1.Connections.Add(connection3);



// add connector shapes

Aspose.Diagram.Shape connector1 = new Aspose.Diagram.Shape();

Aspose.Diagram.Shape connector2 = new Aspose.Diagram.Shape();

Aspose.Diagram.Shape connector3 = new Aspose.Diagram.Shape();

long connecter1Id = diagram.AddShape(connector1, connectorMaster, 0);

long connecter2Id = diagram.AddShape(connector2, connectorMaster, 0);

long connecter3Id = diagram.AddShape(connector3, connectorMaster, 0);

// connect shapes by index of conneecting points

page.ConnectShapesViaConnectorIndex(shape1.ID, 6, shape2.ID, 3, connecter1Id);

page.ConnectShapesViaConnectorIndex(shape1.ID, 1, shape3.ID, 3, connecter2Id);

page.ConnectShapesViaConnectorIndex(shape1.ID, 7, shape4.ID, 3, connecter3Id);

// save drawing

diagram.Save(@"C:\temp\Drawing1_out.vsdx", SaveFileFormat.VSDX);

Récupérer la forme parent d’une sous-forme

Aspose.Diagram for .NET permet aux développeurs de récupérer la forme parent d’une sous-forme.

Obtenir la forme parent

LaFormeLa classe offre la propriété ParentShape pour récupérer la forme parent.

Obtenir l’exemple de programmation de la forme parent

Définir Visio les données XForm, Line et Fill de la forme