Lägg till, hämta, kopiera och läs Visio Shape Data
Lägger till en ny form i Visio
Aspose.Diagram for .NET låter dig manipulera Microsoft Visio diagram på olika sätt. En av sakerna du kan göra är att lägga till nya former till ett diagram. Aspose.Diagram for .NET låter dig lägga till en ny form till en diagram. Den tillagda formen kan också anpassas med Aspose.Diagram for .NET.
Det här avsnittet beskriver hur du lägger till en ny rektangelform till en diagram.
Använd Aspose.Diagram for .NET API för att skapa nya former och lägg sedan till dessa former i en diagram:s formsamling.
Så här lägger du till en ny form:
- Hitta sidan - Varje Visio diagram innehåller en samling sidor. Utvecklare kan hämta sidan efter sid-ID eller namn och lagra den önskade sidan iSidaklassobjekt.
- Lägg till den kräver Master of a Shape - Varje Visio diagram innehåller en samling mästare. Utvecklare kan lägga till en Master (med ID eller Namn) från den befintliga stencilfilen (via direkt sökväg eller filström).
- Lägg till form i Visio diagram - Utvecklare kan placera en ny form i Visio diagram efter sidindex (med början från 0), masternamn, PinX, PinY, höjd (valfritt) och bredd (valfritt).
- Ställ in formegenskaper - AddShape-metoden för klassen Diagram returnerar form-ID. Utvecklare kan hämta form från en Visio diagram genom att använda detta ID och sedan ställa in dess egenskaper, t.ex. färg, position, justering och text.
Ingången diagram
|
diagram med en form tillagd
|
|---|
Lägg till programmeringsexempel
Kodavsnittet nedan visar hur du gör varje steg.
Hämta forminformation
Arbeta med diagramförklarar hur man skapar diagram, lägger till former och kopplingar och sedan hur man hämtar information om diagram element som t.ex.sidor, mästare, kontakter ochteckensnitt. Den här artikeln tittar på hur du hämtar information om former i en diagram.
Varje form i en diagram har ett ID och ett namn. ID:t är viktigt vid programmering med Visio: det är huvudmetoden för att komma åt en form. Varje form behåller också information om vilken master (stencil) den är gjord av.
AForm är ett objekt i en Visio-ritning. Shapes-egenskapen, exponerad av klassen Page, stöder en samling Aspose.Diagram.Shape-objekt. Egenskapen Shapes kan användas för att hämta information om en form.
I konsolfönstret nedan kan du till exempel se informationsutmatning för en diagram som innehöll fyra former: två terminatorer, en process och en dynamisk kontakt. Var och en har ett unikt ID samt namnet på huvudformen (stencil).
| Ett konsolfönster som visar forminformation |
|---|
 |
| För att hämta Visio sidinformation: |
- Laddar en diagram.
- Ställer upp en foreach loop för att gå igenom alla former i diagram.
- Visar forminformation.
Hämta programmeringsexempel
Följande kodbit hämtar forminformationen från en Visio diagram.
Kopiera former från en befintlig Visio
Aspose.Diagram for .NET API tillåter utvecklare att kopiera former från källsidan Visio till den nya sidan Visio diagram. Det stöder också kopiering av gruppformer. Den här artikeln beskriver hur du kopierar alla former från sidan källan diagram.
För att kopiera former bör utvecklare också kopiera källteman för PageSheet och källkod Visio för att bevara formfyllningsstil och andra formateringsegenskaper.
Detta exempel fungerar enligt följande:
- Ladda en källa Visio.
- Initiera ett nytt Visio
- Lägg till masters och teman från källan Visio.
- Hämta sida från källan Visio.
- Kopiera dess PageSheet till den nya Visio-sidan.
- Iterera genom formerna på källsidan Visio.
- Ställ in dess nya id och lägg till den nya sidan Visio.
- Spara det nya Visio i den lokala lagringen.
Kopiera programmeringsexempel
Kopiera en Visio Shape till en annan Shape-instans
Kopieringsmetoden för Shape-klassen kräver en forminstans för att klona.
// 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;Läser Visio Shape Data
Rekvisitasamlingen exponerad avForm klass stöderAspose.Diagram.Prop objekt. Egenskapen kan användas för att läsa en forms data (anpassade egenskaper).
Läs alla formegenskaper
Så här identifierar du anpassade egenskaper i Microsoft Visio:
- I en diagram högerklickar du på en form.
- VäljData , dåFormdata från menyn. Alla befintliga egenskaper listas i dialogrutan.
| En forms data, som ses i Microsoft Visio. | ** |
|---|---|
 |
| Ett konsolfönster som visar formdatautmatningen. | ** |
|---|---|
 |
Läs programmeringsexempel
Kodavsnitten nedan läser formdata (anpassade egenskaper).
Läs en Shape Property efter namn
Kodavsnittet nedan läser en formegenskap efter namn (anpassad egenskap).
Läs efter namn Programmeringsexempel
Läs InheritProps of Shape
Kodavsnittet nedan läser InheritProps av en form.
Lägg till och anslut Visio Former
Aspose.Diagram for .NET låter dig lägga till anpassade former och ansluta dem idiagram du skapar.
Lägga till och ansluta former
Koden i exemplen nedan visar hur man:
- Skapa ett diagram.
- Lägg till och anpassa former (rektangel, stjärna, hexagon).
- Anslut stjärnan och hexagonformerna till rektangeln.
- Spara diagram.
Lägga till och ansluta former Programmeringsexempel
Använd anslutningsindex för att koppla samman former
Aspose.Diagram for .NET API tillåter redan utvecklare att lägga till nya anslutningspunkter på formen, och utvecklare kan nu ansluta former med hjälp av anslutningsindex.
Använd anslutningsindex för att koppla samman former
ConnectShapesViaConnectorIndex-medlemmen exponerad avSidaklass kan användas för att koppla samman former med hjälp av anslutningsindex. Följande kod visar hur man ansluter former:
- Initiera en ny ritning.
- Placera fyra rektangelformer
- Lägg till ytterligare två anslutningspunkter så att det blir tre anslutningspunkter på den nedre gränslinjen
- Anslut den första formen från varje nedre anslutning till andra tre rektangelformer från Top med dynamiska kopplingar
- Spara ritningen
Använd anslutningsindex för att koppla samman former Programmeringsexempel
Använd följande kod i din .NET-applikation för att ansluta former med anslutningsindex med 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);Hämta den överordnade formen för en underform
Aspose.Diagram for .NET tillåter utvecklare att hämta den överordnade formen för en underform.
Skaffa föräldraformen
DeFormclass erbjuder ParentShape-egenskapen för att hämta den överordnade formen.