Dostęp do kształtu nieprymitywnego w programie Excel

Wstęp

Czy kiedykolwiek natknąłeś się na nieprymitywny kształt w pliku Excel i zastanawiałeś się, jak uzyskać dostęp do skomplikowanych szczegółów, które się z nim wiążą? Jeśli jesteś programistą pracującym z .NET i chcesz manipulować arkuszami Excel, jesteś we właściwym miejscu! W tym artykule przyjrzymy się, jak skutecznie uzyskiwać dostęp do nieprymitywnych kształtów i manipulować nimi w programie Excel przy użyciu biblioteki Aspose.Cells. Przeprowadzimy Cię przez kompleksowy przewodnik krok po kroku, który rozbija proces, ułatwiając go nawet osobom początkującym na platformie. Więc usiądź wygodnie i zanurzmy się w fascynującym świecie Aspose.Cells!

Wymagania wstępne

Zanim przejdziemy do kodu, musisz spełnić kilka warunków wstępnych:

  1. Podstawowa znajomość języka C#: Znajomość języka programowania C# jest niezbędna do płynnego zrozumienia tekstu.
  2. Visual Studio: Powinieneś mieć zainstalowany Visual Studio na swoim komputerze. Tutaj napiszemy nasz kod.
  3. Biblioteka Aspose.Cells: Musisz mieć zainstalowaną bibliotekę Aspose.Cells. Możesz pobrać najnowszą wersjęTutaj.
  4. Plik Excel: Utwórz lub uzyskaj plik Excel zawierający nieprymitywne kształty do testowania. W tym samouczku użyjemy"NonPrimitiveShape.xlsx". Gdy już spełnisz te wymagania, możemy przejść do najprzyjemniejszej części!

Importuj pakiety

Pierwszym krokiem do uruchomienia wszystkiego jest zaimportowanie niezbędnych pakietów do projektu C#. Oto, co musisz zrobić:

Utwórz nowy projekt

  • Otwórz program Visual Studio i utwórz nowy projekt aplikacji konsolowej C#.
  • Wybierz odpowiednią nazwę dla swojego projektu, np.AsposeShapeAccess.

Zainstaluj pakiet NuGet Aspose.Cells

  • Kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań.
  • Wybierz „Zarządzaj pakietami NuGet”.
  • SzukajAspose.Cells i kliknij „Zainstaluj”.

Importuj przestrzeń nazw

Na szczycie twojegoProgram.cs plik, zaimportuj przestrzeń nazw Aspose.Cells, dodając następujący wiersz:

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

Teraz zajmijmy się właściwym kodem, który umożliwi nam dostęp do kształtów nieprymitywnych w naszym pliku Excel.

Krok 1: Ustaw ścieżkę do swojego dokumentu

Zanim przejdziemy do dostępu do kształtów, musimy określić katalog, w którym znajduje się plik Excel. Oto jak to zrobić:

string dataDir = "Your Document Directory";

Zastępować"Your Document Directory" z rzeczywistą ścieżką, gdzie jesteśNonPrimitiveShape.xlsx plik jest zapisywany.

Krok 2: Załaduj skoroszyt

Teraz, gdy mamy już skonfigurowaną ścieżkę dokumentu, czas załadować skoroszyt. Oto, jak to zrobić:

Workbook workbook = new Workbook(dataDir + "NonPrimitiveShape.xlsx");

Ta linia tworzy nowyWorkbookobiekt, który odczytuje plik Excel, który wcześniej określiłeś.

Krok 3: Uzyskaj dostęp do arkusza kalkulacyjnego

Następnie uzyskamy dostęp do pierwszego arkusza w skoroszycie. Zróbmy to:

Worksheet worksheet = workbook.Worksheets[0];

Ten wiersz umożliwia dostęp do pierwszego arkusza kalkulacyjnego w skoroszycie — program Excel działa najlepiej, gdy skupiamy się na jednym arkuszu na raz.

Krok 4: Uzyskaj dostęp do kształtu zdefiniowanego przez użytkownika

Teraz nadchodzi ekscytująca część! Uzyskamy dostęp do zdefiniowanego przez użytkownika kształtu (który może być nieprymitywny) w arkuszu kalkulacyjnym.

Shape shape = worksheet.Shapes[0];

Tutaj uzyskujemy dostęp do pierwszego kształtu w arkuszu. Możesz zmienić indeks, jeśli masz wiele kształtów.

Krok 5: Sprawdź, czy kształt nie jest pierwotny

Przed przystąpieniem do uzyskiwania dostępu do szczegółów kształtu kluczowe jest potwierdzenie, czy jest on pierwotny:

if (shape.AutoShapeType == AutoShapeType.NotPrimitive)
{

Ten blok zapewnia, że pracujemy tylko z kształtami zawierającymi bardziej złożone szczegóły.

Krok 6: Uzyskaj dostęp do danych Shape’a

Teraz, gdy potwierdziliśmy, że nie jest to kształt pierwotny, możemy uzyskać dostęp do jego danych.

ShapePathCollection shapePathCollection = shape.Paths;

Ta linia pobiera zbiór ścieżek, które definiują kształt. Pomyśl o tym jak o otrzymaniu planu projektu kształtu!

Krok 7: Przejdź przez każdą ścieżkę

Aby lepiej zrozumieć strukturę kształtu, przejdziemy przez każdą ścieżkę powiązaną z kształtem:

foreach (ShapePath shapePath in shapePathCollection)
{

Ta pętla pozwoli nam zagłębić się w każdą ścieżkę i zbadać jej szczegóły.

Krok 8: Dostęp do segmentów ścieżki

Każda ścieżka kształtu może mieć wiele segmentów. Uzyskajmy do nich dostęp!

ShapeSegmentPathCollection pathSegments = shapePath.PathSegementList;

Zbiór ten zawiera segmenty tworzące ścieżki kształtu.

Krok 9: Przejdź przez każdy segment ścieżki

Tutaj przejdziemy przez każdy segment w kolekcji segmentów ścieżki:

foreach (ShapeSegmentPath pathSegment in pathSegments)
{

Tutaj zaczyna się zabawa, ponieważ zagłębimy się w szczegóły każdego segmentu!

Krok 10: Punkty segmentów ścieżki dostępu

Przejdźmy teraz do poszczególnych punktów w każdym segmencie ścieżki:

ShapePathPointCollection segmentPoints = pathSegment.Points;

Można to porównać do zebrania wszystkich współrzędnych definiujących krzywizny i narożniki kształtu.

Krok 11: Wydrukuj szczegóły punktów

Na koniec wydrukujmy szczegóły każdego punktu w segmencie ścieżki na konsoli:

foreach (ShapePathPoint pathPoint in segmentPoints)
{
    Console.WriteLine("X: " + pathPoint.X + ", Y: " + pathPoint.Y);
}

Dzięki temu w praktyce uzyskujemy współrzędne każdego punktu definiującego nasz nieprymitywny kształt — to fantastyczny sposób na wizualizację tego, co dzieje się „pod maską”!

Wniosek

I masz to! Udało Ci się uzyskać dostęp i zbadać szczegóły nieprymitywnych kształtów w programie Excel przy użyciu Aspose.Cells dla .NET. Ta potężna biblioteka otwiera świat możliwości manipulowania plikami programu Excel, niezależnie od tego, czy generujesz raporty, tworzysz dynamiczne arkusze kalkulacyjne, czy obsługujesz złożone kształty. Jeśli masz jakieś pytania lub potrzebujesz dalszej pomocy, nie wahaj się skontaktować z nami!

Najczęściej zadawane pytania

Czym są kształty nieprymitywne w programie Excel?

Kształty nieprymitywne to złożone kształty składające się z wielu segmentów i krzywych, a nie z prostych form geometrycznych.

Jak zainstalować Aspose.Cells dla .NET?

Można go zainstalować za pomocą Menedżera pakietów NuGet w programie Visual Studio lub pobrać z ich stronystrona.

Czy mogę używać Aspose.Cells za darmo?

Tak, możesz pobrać bezpłatną wersję próbną z ich strony internetowej, aby zapoznać się z jej funkcjamiTutaj.

Jakie są korzyści ze stosowania Aspose.Cells?

Aspose.Cells oferuje zaawansowane funkcje umożliwiające programowe manipulowanie arkuszami kalkulacyjnymi programu Excel bez konieczności instalowania programu Excel na komputerze.

Gdzie mogę znaleźć pomoc dotyczącą Aspose.Cells?

Pomoc i wsparcie możesz uzyskać na forum społeczności AsposeTutaj.

Ustawianie marginesów dla komentarza lub kształtu w programie Excel Odśwież obiekt OLE w programie Excel