Verbindungspunkte einer Form in Excel abrufen

Einführung

Wenn wir programmgesteuert mit Excel-Dateien arbeiten, müssen wir häufig mit in die Blätter eingebetteten Formen interagieren. Eine der fortgeschritteneren Aufgaben, die Sie ausführen können, ist das Extrahieren von Verbindungspunkten aus einer Form. Verbindungspunkte werden verwendet, um Formen mit Verbindern zu verbinden und ihr Layout präziser zu verwalten. Wenn Sie die Verbindungspunkte einer Form in Excel abrufen möchten, ist Aspose.Cells für .NET das richtige Tool für Sie. In diesem Tutorial führen wir Sie Schritt für Schritt durch den Prozess, um dies zu erreichen.

Voraussetzungen

Bevor Sie in den Code eintauchen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Aspose.Cells für .NET: Sie müssen Aspose.Cells in Ihrer Entwicklungsumgebung installiert haben. Wenn Sie es noch nicht haben, können SieLaden Sie hier die neueste Version herunter.
• Entwicklungsumgebung: Stellen Sie sicher, dass Sie über eine funktionierende Installation von Visual Studio oder einer anderen .NET-kompatiblen IDE verfügen.
• Grundlegende Kenntnisse in C#: Dieses Tutorial setzt voraus, dass Sie über grundlegende Kenntnisse der C#-Programmierung und der objektorientierten Prinzipien verfügen. Sie können sich auch anmelden für einekostenlose Testversion von Aspose.Cells falls Sie dies noch nicht getan haben. Dadurch erhalten Sie Zugriff auf alle für dieses Handbuch erforderlichen Funktionen.

Pakete importieren

Um in Ihrem Projekt mit Aspose.Cells arbeiten zu können, müssen Sie die erforderlichen Namespaces einbinden. Die folgenden Importanweisungen sollten am Anfang Ihres Codes platziert werden:

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

Diese Namespaces geben Ihnen Zugriff auf die Kernfunktionalität von Aspose.Cells und ermöglichen Ihnen die Bearbeitung von Arbeitsblättern und Formen.

Schritt-für-Schritt-Anleitung zum Abrufen der Verbindungspunkte einer Form

In diesem Abschnitt zeigen wir Ihnen Schritt für Schritt, wie Sie die Verbindungspunkte einer Form in einem Excel-Arbeitsblatt extrahieren. Befolgen Sie jeden Schritt sorgfältig, damit Sie alles genau verstehen.

Schritt 1: Instanziieren einer neuen Arbeitsmappe

Als erstes müssen wir eine Instanz desWorkbook Klasse. Dies stellt eine Excel-Datei in Aspose.Cells dar. Wenn Sie keine vorhandene Datei haben, ist das kein Problem – Sie können mit einer leeren Arbeitsmappe beginnen.

// Instanziieren einer neuen Arbeitsmappe
Workbook workbook = new Workbook();

In diesem Schritt haben wir eine leere Excel-Arbeitsmappe erstellt. Sie können jedoch auch eine vorhandene laden, indem Sie den Dateipfad an dieWorkbook Konstruktor.

Schritt 2: Zugriff auf das erste Arbeitsblatt

Als Nächstes müssen wir auf das Arbeitsblatt zugreifen, in dem wir mit Formen arbeiten möchten. In diesem Fall verwenden wir das erste Arbeitsblatt der Arbeitsmappe.

// Holen Sie sich das erste Arbeitsblatt in der Arbeitsmappe
Worksheet worksheet = workbook.Worksheets[0];

Diese Zeile greift auf das erste Arbeitsblatt aus der Sammlung von Arbeitsblättern in der Arbeitsmappe zu. Wenn Sie mit einem bestimmten Blatt arbeiten, können Sie den Index ersetzen0 mit dem gewünschten Index.

Schritt 3: Neues Textfeld (Form) hinzufügen

Fügen wir nun dem Arbeitsblatt eine neue Form hinzu. Wir erstellen ein Textfeld, also eine Art Form. Sie können auch andere Formen hinzufügen, der Einfachheit halber beschränken wir uns in diesem Tutorial jedoch auf ein Textfeld.

// Fügen Sie der Sammlung ein neues Textfeld hinzu
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);

Folgendes haben wir getan:

• Ein Textfeld wurde in der Zeile hinzugefügt2 , Spalte1.
• Stellen Sie die Abmessungen des Textfelds ein auf160 Einheiten in Breite und200 Einheiten in der Höhe.

Schritt 4: Zugriff auf die Form aus der Formensammlung

Sobald wir das Textfeld hinzugefügt haben, wird es Teil der Formensammlung des Arbeitsblatts. Jetzt greifen wir auf diese Form zu, indem wirShapesSammlung.

// Zugriff auf die Form (Textfeld) aus der Formensammlung
Shape shape = workbook.Worksheets[0].Shapes[0];

In diesem Schritt rufen wir die erste Form (unser Textfeld) aus der Sammlung ab. Wenn Sie mehrere Formen haben, können Sie den Index angeben oder die Form sogar nach Namen suchen.

Schritt 5: Verbindungspunkte abrufen

Nachdem wir nun unsere Form haben, extrahieren wir ihre Verbindungspunkte. Diese Punkte werden zum Anfügen von Verbindungsstücken an die Form verwendet. DieConnectionPoints Die Eigenschaft der Form gibt alle verfügbaren Verbindungspunkte zurück.

// Holen Sie sich alle Verbindungspunkte in dieser Form
var connectionPoints = shape.ConnectionPoints;

Dadurch erhalten wir eine Sammlung aller für diese Form verfügbaren Verbindungspunkte.

Schritt 6: Verbindungspunkte anzeigen

Schließlich möchten wir die Koordinaten jedes Verbindungspunkts anzeigen. Dazu durchlaufen wir die Verbindungspunkte und geben sie auf der Konsole aus.

// Alle Formpunkte anzeigen
foreach (var pt in connectionPoints)
{
    System.Console.WriteLine(string.Format("X = {0}, Y = {1}", pt.X, pt.Y));
}

Diese Schleife durchläuft jeden Verbindungspunkt und gibt dieX UndY Koordinaten. Dies kann zum Debuggen oder zur visuellen Bestätigung der Verbindungspunkte einer Form nützlich sein.

Schritt 7: Ausführen und Abschließen

Sobald Sie alle oben genannten Schritte eingerichtet haben, können Sie den Code ausführen. Hier ist die letzte Zeile, die sicherstellt, dass der Vorgang erfolgreich abgeschlossen wird:

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

Diese Zeile protokolliert lediglich eine Meldung an die Konsole, die angibt, dass der Vorgang abgeschlossen wurde.

Abschluss

In diesem Tutorial haben wir erläutert, wie Sie mit Aspose.Cells für .NET Verbindungspunkte einer Form in Excel abrufen. Indem wir die Aufgabe in kleine, überschaubare Schritte unterteilten, haben wir den Prozess des Erstellens einer Arbeitsmappe, des Hinzufügens einer Form und des Extrahierens der Verbindungspunkte untersucht. Wenn Sie verstehen, wie Sie Formen programmgesteuert bearbeiten, eröffnen sich Ihnen unzählige Möglichkeiten zum Erstellen dynamischer und interaktiver Excel-Tabellen. Egal, ob Sie Berichte erstellen, Dashboards entwerfen oder Diagramme erstellen, dieses Wissen wird Ihnen von Nutzen sein.

Häufig gestellte Fragen

Was ist ein Verbindungspunkt in einer Form?

Ein Verbindungspunkt ist ein bestimmter Punkt auf einer Form, an dem Sie Verbindungsstücke anbringen oder die Form mit anderen Formen verknüpfen können.

Kann ich Verbindungspunkte für alle Formen in einem Arbeitsblatt abrufen?

Ja, mit Aspose.Cells können Sie Verbindungspunkte für jede Form abrufen, die diese unterstützt. Durchlaufen Sie einfach die Formensammlung im Arbeitsblatt.

Benötige ich eine Lizenz, um Aspose.Cells zu verwenden?

Ja, Sie können es zwar kostenlos testen, für den vollen Funktionsumfang ist jedoch eine Lizenz erforderlich. Sie könnenKaufen Sie hier eine Lizenzoder erhalten Sie einevorläufige Lizenz.

Wie kann ich in Aspose.Cells verschiedene Arten von Formen hinzufügen?

Sie können dieAdd Methode für Formen wie Rechtecke, Ellipsen usw. Jede Form hat spezifische Parameter, die Sie anpassen können.

Wie lade ich eine vorhandene Excel-Datei, anstatt eine neue zu erstellen?

Um eine vorhandene Datei zu laden, übergeben Sie den Dateipfad an dieWorkbook Konstruktor, wie folgt:

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