Szerezzen be alakzati pontokat az Excelben

Bevezetés

Amikor programozottan dolgozunk Excel fájlokkal, gyakran kell interakcióba lépnünk a lapokba ágyazott alakzatokkal. Az egyik legfejlettebb feladat, amelyet elvégezhet, a csatlakozási pontok kinyerése egy alakzatból. A csatlakozási pontok alakzatok csatlakozókkal történő rögzítésére és elrendezésük pontosabb kezelésére szolgálnak. Ha egy alakzat kapcsolódási pontjait szeretné megszerezni az Excelben, akkor az Aspose.Cells for .NET a szükséges eszköz. Ebben az oktatóanyagban lépésről lépésre végigvezetjük Önt ennek eléréséhez.

Előfeltételek

Mielőtt belemerülne a kódba, győződjön meg arról, hogy rendelkezik a következő előfeltételekkel:

• Aspose.Cells for .NET: Az Aspose.Cells programot telepíteni kell a fejlesztői környezetbe. Ha még nincs meg, megtehetitöltse le a legújabb verziót innen.
• Fejlesztői környezet: Győződjön meg arról, hogy rendelkezik működő Visual Studio vagy bármely más .NET-kompatibilis IDE telepítéssel.
• Alapvető C# ismerete: Ez az oktatóanyag feltételezi, hogy rendelkezik a C# programozás és az objektumorientált elvek alapvető ismereteivel. Jelentkezni is lehet aAz Aspose.Cells ingyenes próbaverziója ha még nem tetted meg. Ezzel hozzáférést biztosít az útmutatóhoz szükséges összes funkcióhoz.

Csomagok importálása

Az Aspose.Cells használatához a projektben fel kell vennie a szükséges névtereket. A következő importálási utasításokat kell elhelyezni a kód tetején:

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

Ezek a névterek hozzáférést biztosítanak az Aspose.Cells alapvető funkcióihoz, és lehetővé teszik a munkalapok és alakzatok kezelését.

Lépésről lépésre egy alakzat kapcsolódási pontjainak megszerzéséhez

Ebben a részben végigvezetjük, hogyan bonthatja ki egy alakzat kapcsolódási pontjait egy Excel-munkalapon. Kövesse gondosan az egyes lépéseket a világos megértés érdekében.

1. lépés: Példányosítson egy új munkafüzetet

Először is létre kell hoznunk egy példányt aWorkbook osztály. Ez egy Excel-fájlt jelöl az Aspose.Cells-ben. Ha nincs meglévő fájlja, semmi gond – kezdheti egy üres munkafüzettel.

// Példányosítson egy új munkafüzetet
Workbook workbook = new Workbook();

Ebben a lépésben létrehoztunk egy üres Excel-munkafüzetet, de betölthet egy meglévőt is, ha átadja a fájl elérési útját aWorkbook konstruktőr.

2. lépés: Nyissa meg az első munkalapot

Ezután el kell érnünk azt a munkalapot, ahol az alakzatokkal szeretnénk dolgozni. Ebben az esetben a munkafüzet első munkalapját használjuk.

// Szerezd meg az első munkalapot a munkafüzetben
Worksheet worksheet = workbook.Worksheets[0];

Ez a sor a munkafüzet munkalapgyűjteményének első munkalapját éri el. Ha egy adott lappal dolgozik, lecserélheti az indexet0 a kívánt indexszel.

3. lépés: Új szövegmező hozzáadása (alakzat)

Most adjunk hozzá egy új alakzatot a munkalaphoz. Létrehozunk egy szövegdobozt, amely egy alakzattípus. Más típusú alakzatokat is hozzáadhat, de az egyszerűség kedvéért ebben az oktatóanyagban maradunk egy szövegdoboznál.

// Új szövegdoboz hozzáadása a gyűjteményhez
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);

Íme, mit tettünk:

• Hozzáadott egy szövegmezőt a sorhoz2 , oszlop1.
• Állítsa be a szövegdoboz méreteit160 egységek szélességében és200 egységek magasságban.

4. lépés: Nyissa meg az Alakzatot az Alakzatgyűjteményből

Miután hozzáadtuk a szövegdobozt, az a munkalap alakzatgyűjteményének részévé válik. Most elérjük ezt az alakzatot aShapesgyűjtemény.

// Hozzáférés az alakzathoz (szövegdoboz) az alakzatgyűjteményből
Shape shape = workbook.Worksheets[0].Shapes[0];

Ebben a lépésben lekérjük az első alakzatot (a szövegdobozunkat) a gyűjteményből. Ha több alakzata van, megadhatja az indexet, vagy akár név szerint is megkeresheti az alakzatot.

5. lépés: Kapcsolódási pontok lekérése

Most, hogy megvan az alakunk, vegyük ki a kapcsolódási pontjait. Ezeket a pontokat a csatlakozók alakhoz való rögzítésére használják. AConnectionPoints Az alakzat tulajdonsága visszaadja az összes elérhető kapcsolódási pontot.

// Szerezzen be minden csatlakozási pontot ebben az alakban
var connectionPoints = shape.ConnectionPoints;

Ez az alakzathoz rendelkezésre álló összes csatlakozási pont gyűjteményét adja.

6. lépés: Csatlakozási pontok megjelenítése

Végül az egyes csatlakozási pontok koordinátáit szeretnénk megjeleníteni. Itt áthurkoljuk a csatlakozási pontokat, és kinyomtatjuk a konzolra.

// Az összes alakpont megjelenítése
foreach (var pt in connectionPoints)
{
    System.Console.WriteLine(string.Format("X = {0}, Y = {1}", pt.X, pt.Y));
}

Ez a ciklus minden kapcsolódási ponton áthalad, és kinyomtatja aX ésY koordináták. Ez hasznos lehet a hibakereséshez vagy egy alakzat kapcsolódási pontjainak vizuális megerősítéséhez.

7. lépés: Végezze el és fejezze be

Miután beállította az összes fenti lépést, futtathatja a kódot. Íme az utolsó sor, amely biztosítja a folyamat sikeres befejezését:

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

Ez a sor egyszerűen egy üzenetet naplóz a konzolon, jelezve, hogy a folyamat befejeződött.

Következtetés

Ebben az oktatóanyagban bemutattuk, hogyan lehet lekérni egy alakzat kapcsolódási pontjait az Excelben az Aspose.Cells for .NET használatával. A feladatot apró, emészthető lépésekre bontva feltártuk a munkafüzet létrehozásának, az alakzat hozzáadásának és a kapcsolódási pontok kinyerésének folyamatát. Az alakzatok programozott kezelésének megértésével a lehetőségek világa nyílik meg a dinamikus és interaktív Excel-lapok készítésében. Mindegy, hogy jelentéseket készít, irányítópultokat vagy diagramokat készít, ez a tudás hasznos lesz.

GYIK

Mi az a kapcsolódási pont egy alakzatban?

A csatlakozási pont egy adott pont az alakzaton, ahol csatlakozókat csatlakoztathat, vagy más alakzatokhoz kapcsolhatja.

Lekérhetem a kapcsolódási pontokat egy munkalapon lévő összes alakzathoz?

Igen, az Aspose.Cells lehetővé teszi bármely olyan alakzat csatlakozási pontjainak lekérését, amely támogatja azokat. Egyszerűen lapozzon át az alakzatgyűjteményben a munkalapon.

Szükségem van engedélyre az Aspose.Cells használatához?

Igen, bár ingyenesen kipróbálhatja, a teljes szolgáltatáshoz licenc szükséges. Tudodvásároljon itt licencetvagy kap aideiglenes engedély.

Hogyan adhatok hozzá különböző típusú alakzatokat az Aspose.Cells-hez?

Használhatja aAdd módszer alakzatokhoz, például téglalapokhoz, ellipszisekhez stb. Minden alakzatnak sajátos paraméterei vannak, amelyeket személyre szabhat.

Hogyan tölthetek be egy meglévő Excel-fájlt egy új létrehozása helyett?

Meglévő fájl betöltéséhez adja át a fájl elérési útját aWorkbook konstruktor, így:

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