Ottieni i punti di connessione della forma in Excel

Introduzione

Quando si lavora con file Excel a livello di programmazione, spesso è necessario interagire con forme incorporate nei fogli. Una delle attività più avanzate che puoi eseguire è l’estrazione di punti di connessione da una forma. I punti di connessione vengono utilizzati per collegare forme con connettori e gestire il loro layout in modo più preciso. Se stai cercando di ottenere i punti di connessione di una forma in Excel, Aspose.Cells per .NET è lo strumento di cui hai bisogno. In questo tutorial, ti guideremo attraverso un processo passo dopo passo per ottenere questo risultato.

Prerequisiti

Prima di immergerti nel codice, assicurati di disporre dei seguenti prerequisiti:

• Aspose.Cells per .NET: dovrai avere Aspose.Cells installato nel tuo ambiente di sviluppo. Se non lo hai ancora, puoiscarica l’ultima versione qui.
• Ambiente di sviluppo: assicurati di avere un’installazione funzionante di Visual Studio o di qualsiasi altro IDE compatibile con .NET.
• Conoscenza di base di C#: questo tutorial presuppone una conoscenza di base della programmazione C# e dei principi orientati agli oggetti. Puoi anche iscriverti a unprova gratuita di Aspose.Cells se non l’hai già fatto. Questo ti darà accesso a tutte le funzionalità richieste per questa guida.

Importa pacchetti

Per lavorare con Aspose.Cells nel tuo progetto, devi includere i namespace necessari. Le seguenti istruzioni di importazione devono essere inserite all’inizio del tuo codice:

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

Questi namespace consentono di accedere alle funzionalità principali di Aspose.Cells e di manipolare fogli di lavoro e forme.

Guida passo passo per ottenere i punti di connessione di una forma

In questa sezione, ti guideremo attraverso l’estrazione dei punti di connessione di una forma all’interno di un foglio di lavoro Excel. Segui attentamente ogni passaggio per una chiara comprensione.

Passaggio 1: creare una nuova cartella di lavoro

Prima di tutto, dobbiamo creare un’istanza diWorkbook classe. Rappresenta un file Excel in Aspose.Cells. Se non hai un file esistente, nessun problema: puoi iniziare con una cartella di lavoro vuota.

// Crea un'istanza di una nuova cartella di lavoro
Workbook workbook = new Workbook();

In questo passaggio, abbiamo creato una cartella di lavoro Excel vuota, ma puoi anche caricarne una esistente passando il percorso del file alWorkbook costruttore.

Passaggio 2: accedi al primo foglio di lavoro

Poi, dobbiamo accedere al foglio di lavoro in cui vogliamo lavorare con le forme. In questo caso, useremo il primo foglio di lavoro della cartella di lavoro.

// Ottieni il primo foglio di lavoro nella cartella di lavoro
Worksheet worksheet = workbook.Worksheets[0];

Questa riga accede al primo foglio di lavoro dalla raccolta di fogli di lavoro nella cartella di lavoro. Se stai lavorando con un foglio specifico, puoi sostituire l’indice0 con l’indice desiderato.

Passaggio 3: aggiungere una nuova casella di testo (forma)

Ora, aggiungiamo una nuova forma al foglio di lavoro. Creeremo una casella di testo, che è un tipo di forma. Puoi anche aggiungere altri tipi di forme, ma per semplicità, in questo tutorial ci limiteremo a una casella di testo.

// Aggiungi una nuova casella di testo alla raccolta
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);

Ecco cosa abbiamo fatto:

• Aggiunta una casella di testo alla riga2 , colonna1.
• Imposta le dimensioni della casella di testo su160 unità in larghezza e200 unità di altezza.

Passaggio 4: accedere alla forma dalla raccolta Forme

Una volta aggiunta la casella di testo, questa diventa parte della raccolta di forme del foglio di lavoro. Ora accederemo a quella forma usandoShapescollezione.

// Accedi alla forma (casella di testo) dalla raccolta di forme
Shape shape = workbook.Worksheets[0].Shapes[0];

In questo passaggio, recuperiamo la prima forma (la nostra casella di testo) dalla raccolta. Se hai più forme, puoi specificare l’indice o persino trovare la forma per nome.

Passaggio 5: Recupera i punti di connessione

Ora che abbiamo la nostra forma, estraiamo i suoi punti di connessione. Questi punti vengono utilizzati per collegare i connettori alla forma. IlConnectionPoints la proprietà della forma restituisce tutti i punti di connessione disponibili.

// Ottieni tutti i punti di connessione in questa forma
var connectionPoints = shape.ConnectionPoints;

Questo ci fornisce una raccolta di tutti i punti di connessione disponibili per quella forma.

Passaggio 6: visualizzare i punti di connessione

Infine, vogliamo visualizzare le coordinate di ogni punto di connessione. Qui è dove facciamo un ciclo attraverso i punti di connessione e li stampiamo sulla console.

// Visualizza tutti i punti della forma
foreach (var pt in connectionPoints)
{
    System.Console.WriteLine(string.Format("X = {0}, Y = {1}", pt.X, pt.Y));
}

Questo ciclo esegue un’iterazione su ogni punto di connessione e stampa ilX EY coordinate. Questo può essere utile per il debug o per confermare visivamente i punti di connessione di una forma.

Passaggio 7: eseguire e completare

Una volta impostati tutti i passaggi sopra, puoi eseguire il codice. Ecco la riga finale che assicura che il processo venga completato correttamente:

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

Questa riga registra semplicemente un messaggio sulla console indicando che il processo è stato completato.

Conclusione

In questo tutorial, abbiamo spiegato come recuperare i punti di connessione di una forma in Excel usando Aspose.Cells per .NET. Suddividendo l’attività in piccoli passaggi digeribili, abbiamo esplorato il processo di creazione di una cartella di lavoro, aggiunta di una forma ed estrazione dei punti di connessione. Comprendendo come manipolare le forme a livello di programmazione, si apre un mondo di possibilità per la creazione di fogli Excel dinamici e interattivi. Che si tratti di creare report, progettare dashboard o creare diagrammi, questa conoscenza tornerà utile.

Domande frequenti

Cos’è un punto di connessione in una forma?

Un punto di connessione è un punto specifico su una forma a cui è possibile collegare dei connettori o collegarla ad altre forme.

Posso recuperare i punti di connessione per tutte le forme in un foglio di lavoro?

Sì, Aspose.Cells consente di recuperare punti di connessione per qualsiasi forma che li supporti. Basta scorrere la raccolta di forme nel foglio di lavoro.

Ho bisogno di una licenza per utilizzare Aspose.Cells?

Sì, mentre puoi provarlo gratuitamente, è richiesta una licenza per le funzionalità complete. Puoiacquista una licenza qui ottenere unlicenza temporanea.

Come posso aggiungere diversi tipi di forme in Aspose.Cells?

Puoi usare ilAdd metodo per forme come rettangoli, ellissi e altro. Ogni forma ha parametri specifici che puoi personalizzare.

Come faccio a caricare un file Excel esistente invece di crearne uno nuovo?

Per caricare un file esistente, passare il percorso del file alWorkbook costruttore, in questo modo:

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