Kształty renderowania Oddzielnie od dokumentu
Podczas przetwarzania dokumentów wspólnym zadaniem jest wydobycie wszystkich obrazów znalezionych w dokumencie i wywiezienie ich do miejsca zewnętrznego. To zadanie staje się proste z Aspose.Words API, która już zapewnia funkcjonalność do pobierania i zapisywania danych obrazu. Jednak czasami można chcieć podobnie wyodrębnić inne rodzaje treści graficznych, które są reprezentowane przez inny typ obiektu rysowania, na przykład pole tekstowe zawierające akapity, kształty strzałek i mały obraz. Nie ma prostego sposobu renderowania tego obiektu, ponieważ jest to kombinacja poszczególnych elementów treści. Można również napotkać przypadek, gdy zawartość została zgrupowana w obiekt, który wygląda jak jeden obraz.
Aspose.Words zapewnia funkcjonalność do ekstrakcji tego typu treści w ten sam sposób można pobrać prosty obraz z kształtu jako treści renderowanej. Ten artykuł opisuje, jak wykorzystać tę funkcjonalność do renderowania kształtów niezależnie od dokumentu.
Rodzaje kształtów Aspose.Words
Cała zawartość w warstwie rysunku dokumentu jest reprezentowana przez Shape lub GroupShape węzeł Aspose.Words Moduł obiektu dokumentu (DOM). Taka zawartość może być pola tekstowe, obrazy, autoShapes, obiekty OLE, itp. Niektóre pola są również importowane jako kształty, na przykład, INCLUDEPICTURE Pole.
Prosty obraz jest reprezentowany przez Shape węzeł ShapeType.Image. Ten węzeł kształtu nie ma węzłów dziecięcych, ale dane obrazu zawarte w węźle kształtu mogą być dostępne przez Shape.ImageData nieruchomości. Z drugiej strony, kształt może być również złożony z wielu węzłów dziecięcych. Na przykład, kształt pola tekstowego, który jest reprezentowany przez ShapeType.TextBox nieruchomości, może być złożony z wielu węzłów, takich jak Paragraph oraz Table. Większość kształtów może obejmować Paragraph oraz Table węzły poziomu blokady. Są to te same węzły, które pojawiają się w głównym ciele. Kształty są zawsze częściami niektórych punktów, albo zawarte bezpośrednio inline lub zakotwiczone do Ustęp ale “pływające” gdziekolwiek na stronie dokumentu.
Dokument może również zawierać kształty zgrupowane razem. Groupw Microsoft Word wybierając wiele obiektów i klikając “Group"w prawym menu.
W Aspose.Words, te grupy kształtów są reprezentowane przez GroupShape węzeł. Mogą one być również wywoływane w ten sam sposób, aby uczynić całą grupę do obrazu.
Format DOCX może zawierać specjalne typy obrazów, takie jak schematy lub wykresy. Kształty te są również reprezentowane przez Shape węzeł Aspose.Words, co również zapewnia podobną metodę renderowania ich jako obrazów. Kształt nie może zawierać innego kształtu jako dziecko, chyba że jest to obraz (ShapeType.Image). Na przykład: Microsoft Word nie pozwala na umieszczenie pola tekstowego w innym polu tekstowym.
Opisane powyżej typy kształtu stanowią specjalną metodę renderowania kształtów przez ShapeRenderer Klasa. Przykładem ShapeRenderer klasa jest pobierana dla Shape lub GroupShape przez GetShapeRenderer metody lub przez podanie Shape do konstruktora ShapeRenderer Klasa. Klasa ta zapewnia dostęp do członków, które umożliwiają nadanie kształtu:
- Plik na dysku przy użyciu Save przeciążenie metody
- Strumień przy użyciu Save przeciążenie metody
- Grafika Obiekt za pomocą RenderToSize oraz RenderToScale metody
Renderowanie pliku lub strumienia
W Save metoda zapewnia przeciążenia, które renderują kształt bezpośrednio do pliku lub strumienia. Oba przeładunki akceptują przykład ImageSaveOptions klasa, która pozwala definiować opcje renderowania kształtu. Działa to tak samo jak Document.Save Metoda. Nawet jeśli ten parametr jest wymagany, możesz podać wartość null, określając, że nie ma własnych opcji.
Kształt może być eksportowany w dowolnym formacie obrazka określonym w SaveFormat wyliczenie. Na przykład, obraz może być renderowany jako obraz rastrowy, takie jak JPEG poprzez określenie SaveFormat.Jpeg wyliczenie, lub jako obraz wektorowy, takie jak EMF poprzez określenie SaveFormat.Emf.
Poniższy przykład kodu ilustruje nadanie kształtu obrazowi EMF oddzielnie od dokumentu i zapisywanie na dysku:
Poniższy przykład kodu ilustruje nadanie kształtu obrazowi JPEG oddzielnie od dokumentu i zapisywanie do strumienia:
W ImageSaveOptions klasa pozwala na określenie różnych opcji, które kontrolują sposób renderowania obrazu. Opisaną powyżej funkcjonalność można zastosować w ten sam sposób do GroupShape oraz Shape węzły.
Wypożyczanie Graphics Obiekt
Renderowanie bezpośrednio do Graphics obiekt pozwala na zdefiniowanie własnych ustawień i stanu Graphics obiekt. Wspólny scenariusz zakłada przekształcenie kształtu bezpośrednio w Graphics obiekt odzyskany z Windows Forma albo Bitmap. Kiedy Shape węzeł jest renderowany, ustawienia będą miały wpływ na wygląd kształtu. Na przykład, można obracać lub skalować kształt za pomocą RotateTransform lub ScaleTransform metody Graphics obiekt.
Poniższy przykład pokazuje, jak zmienić kształt Graphics obiekt oddzielnie od dokumentu i zastosować rotację do renderowanego obrazu:
Podobnie RenderToSize metoda RenderToSizemetoda dziedziczona od NodeRendererBase jest przydatny do tworzenia miniatur zawartości dokumentu. Rozmiar kształtu jest określony za pośrednictwem konstruktora. W RenderToSize metoda akceptuje Graphics obiekt, współrzędne X i Y pozycji obrazu oraz rozmiar obrazu (szerokość i wysokość), który zostanie narysowany na obrazku Graphics obiekt.
W Shape może być renderowane do określonej skali za pomocą ShapeRenderer.RenderToScale metoda dziedziczona od NodeRendererBase Klasa. Jest to podobne do Document.RenderToScale metoda akceptująca te same główne parametry. Różnica pomiędzy tymi dwoma metodami jest taka, że z ShapeRenderer.RenderToScale metoda, zamiast dosłownego rozmiaru, wybrać zmienną wartość, która skaluje kształt podczas renderowania. Jeśli wartość float równa się 1.0 powoduje, że kształt jest renderowany przy 100% jego oryginalnego rozmiaru. Wartość zmienna 0,5 zmniejszy rozmiar obrazu o połowę.
Renderowanie obrazu kształtu
W Shape klasa reprezentuje obiekty w warstwie rysunku, takie jak autoShape, text box, freeform, OLE obiekt, ActiveX kontroli, lub obraz. Korzystanie z Shape klasy, można tworzyć lub modyfikować kształty w Microsoft Word dokument. Ważną właściwością kształtu jest jego ShapeType. Kształty różnych typów mogą mieć różne możliwości w dokumencie Word. Na przykład, tylko obrazy i kształty OLE mogą mieć obrazy wewnątrz nich, podczas gdy większość kształtów może mieć tylko tekst.
Poniższy przykład pokazuje, jak wykonać obraz kształtu na obrazek JPEG oddzielnie od dokumentu i zapisać go na dysku:
Pobieranie rozmiaru kształtu
W ShapeRenderer klasa zapewnia również funkcjonalność, aby odzyskać rozmiar kształtu w pikselach poprzez GetSizeInPixels Metoda. Metoda ta akceptuje dwa parametry float (Single) - skalę i DPI, które są wykorzystywane do obliczania wielkości kształtu, gdy kształt jest renderowany. Metoda zwraca Size obiekt, który zawiera szerokość i wysokość obliczonego rozmiaru. Jest to przydatne, gdy jest wymagane, aby znać rozmiar renderowanego kształtu z wyprzedzeniem, na przykład podczas tworzenia nowej mapy Bitmap z renderowanego wyjścia.
Poniższy przykład pokazuje jak stworzyć nowy obiekt Bitmap i Graphics o szerokości i wysokości renderowanego kształtu:
Podczas stosowania RenderToSize lub RenderToScale metody, rozmiar renderowanego obrazu jest również zwracany w SizeF obiekt. Można to przypisać do zmiennej i w razie potrzeby wykorzystać.
W SizeInPoints właściwość zwraca rozmiar kształtu mierzony w punktach (patrz ShapeRenderer). Wynik jest SizeF obiekt zawierający szerokość i wysokość.