Zarządzanie kształtami prezentacji na Androidzie

Przegląd

Ten artykuł wyjaśnia, jak pracować z kształtami w prezentacjach przy użyciu Aspose.Slides. Pokazuje, jak znaleźć kształt na slajdzie, sklonować go, usunąć, ukryć, zmienić jego kolejność, uzyskać identyfikator Interop kształtu oraz ustawić tekst alternatywny w celu identyfikacji i dalszego przetwarzania.

Omówiono także, jak uzyskać dostęp do formatów układu dla kształtów, renderować kształt jako SVG, wyrównywać kształty na slajdzie oraz używać właściwości odbicia do poziomego i pionowego lustrzanego odbicia. Dodatkowo artykuł zawiera krótkie FAQ dotyczące łączenia kształtów, kolejności warstw oraz blokowania kształtów.

Znajdowanie kształtu na slajdzie

Ten temat opisuje prostą technikę ułatwiającą programistom znajdowanie konkretnego kształtu na slajdzie bez użycia jego wewnętrznego Id. Należy wiedzieć, że pliki prezentacji PowerPoint nie posiadają żadnego sposobu identyfikacji kształtów na slajdzie oprócz wewnętrznego unikalnego Id. Dla programistów może być trudne znalezienie kształtu przy użyciu tego wewnętrznego Id. Wszystkie kształty dodane do slajdów mają pewien tekst alternatywny. Sugerujemy programistom użycie tekstu alternatywnego do znajdowania konkretnego kształtu. Możesz użyć MS PowerPoint do zdefiniowania tekstu alternatywnego dla obiektów, które planujesz zmienić w przyszłości.

Po ustawieniu tekstu alternatywnego dowolnego pożądanego kształtu, możesz otworzyć tę prezentację przy użyciu Aspose.Slides for Android via Java i iterować po wszystkich kształtach dodanych do slajdu. Podczas każdej iteracji możesz sprawdzić tekst alternatywny kształtu, a kształt z pasującym tekstem alternatywnym będzie tym, którego potrzebujesz. Aby lepiej zobrazować tę technikę, stworzyliśmy metodę, findShape która umożliwia znalezienie konkretnego kształtu na slajdzie i po prostu zwraca ten kształt.

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji
Presentation pres = new Presentation("FindingShapeInSlide.pptx");
try {

    ISlide slide = pres.getSlides().get_Item(0);
    // Alternatywny tekst kształtu, który ma zostać znaleziony
    IShape shape = findShape(slide, "Shape1");
    if (shape != null)
    {
        System.out.println("Shape Name: " + shape.getName());
    }
} finally {
    if (pres != null) pres.dispose();
}

// Implementacja metody do znajdowania kształtu na slajdzie przy użyciu jego tekstu alternatywnego
public static IShape findShape(ISlide slide, String alttext)
{
    // Iterowanie po wszystkich kształtach wewnątrz slajdu
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        // Jeśli tekst alternatywny kształtu pasuje do wymaganego, wtedy
        // Zwróć kształt
        if (slide.getShapes().get_Item(i).getAlternativeText().compareTo(alttext) == 0)
            return slide.getShapes().get_Item(i);
    }
    return null;
}

Klonowanie kształtu

Aby sklonować kształt na slajd przy użyciu Aspose.Slides for Android via Java:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj referencję do slajdu, używając jego indeksu.
  3. Uzyskaj dostęp do kolekcji kształtów slajdu źródłowego.
  4. Dodaj nowy slajd do prezentacji.
  5. Sklonuj kształty z kolekcji kształtów slajdu źródłowego do nowego slajdu.
  6. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Poniższy przykład dodaje grupowy kształt do slajdu.

// Utwórz instancję klasy Presentation
Presentation pres = new Presentation("Source Frame.pptx");
try {
    IShapeCollection sourceShapes = pres.getSlides().get_Item(0).getShapes();
    ILayoutSlide blankLayout = pres.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank);
    ISlide destSlide = pres.getSlides().addEmptySlide(blankLayout);
    IShapeCollection destShapes = destSlide.getShapes();
    destShapes.addClone(sourceShapes.get_Item(1), 50, 150 + sourceShapes.get_Item(0).getHeight());
    destShapes.addClone(sourceShapes.get_Item(2));
    destShapes.insertClone(0, sourceShapes.get_Item(0), 50, 150);

    // Zapisz plik PPTX na dysk
    pres.save("CloneShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Usuwanie kształtu

Aspose.Slides for Android via Java umożliwia programistom usunięcie dowolnego kształtu. Aby usunąć kształt z dowolnego slajdu, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj dostęp do pierwszego slajdu.
  3. Znajdź kształt o określonym AlternativeText.
  4. Usuń kształt.
  5. Zapisz plik na dysku.
// Utwórz obiekt Presentation
Presentation pres = new Presentation();
try {
    // Pobierz pierwszy slajd
    ISlide sld = pres.getSlides().get_Item(0);

    // Dodaj autokształt typu prostokąt
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(0);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            sld.getShapes().remove(ashp);
        }
    }

    // Zapisz prezentację na dysku
    pres.save("RemoveShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Ukrywanie kształtu

Aspose.Slides for Android via Java umożliwia programistom ukrycie dowolnego kształtu. Aby ukryć kształt na dowolnym slajdzie, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj dostęp do pierwszego slajdu.
  3. Znajdź kształt o określonym AlternativeText.
  4. Ukryj kształt.
  5. Zapisz plik na dysku.
// Utwórz instancję klasy Presentation, która reprezentuje plik PPTX
Presentation pres = new Presentation();
try {
    // Pobierz pierwszy slajd
    ISlide sld = pres.getSlides().get_Item(0);

    // Dodaj autokształt typu prostokąt
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String alttext = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(i);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            ashp.setHidden(true);
        }
    }

    // Zapisz prezentację na dysk
    pres.save("Hiding_Shapes_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Zmienianie kolejności kształtów

Aspose.Slides for Android via Java umożliwia programistom zmianę kolejności kształtów. Zmiana kolejności określa, który kształt jest na wierzchu, a który z tyłu. Aby zmienić kolejność kształtów na dowolnym slajdzie, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj dostęp do pierwszego slajdu.
  3. Dodaj kształt.
  4. Dodaj trochę tekstu w ramce tekstowej kształtu.
  5. Dodaj kolejny kształt o tych samych współrzędnych.
  6. Zmień kolejność kształtów.
  7. Zapisz plik na dysku.
Presentation pres = new Presentation("ChangeShapeOrder.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shp3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
    shp3.getFillFormat().setFillType(FillType.NoFill);
    shp3.addTextFrame(" ");

    IParagraph para = shp3.getTextFrame().getParagraphs().get_Item(0);
    IPortion portion = para.getPortions().get_Item(0);
    portion.setText("Watermark Text Watermark Text Watermark Text");

    shp3 = slide.getShapes().addAutoShape(ShapeType.Triangle, 200, 365, 400, 150);

    slide.getShapes().reorder(2, shp3);

    pres.save("Reshape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Pobieranie Interop Shape ID

Aspose.Slides for Android via Java umożliwia programistom uzyskanie unikalnego identyfikatora kształtu w zakresie slajdu, w przeciwieństwie do metody getUniqueId która pozwala uzyskać unikalny identyfikator w zakresie prezentacji. Metoda getOfficeInteropShapeId została dodana do interfejsu IShape oraz klasy Shape. Wartość zwracana przez metodę getOfficeInteropShapeId odpowiada wartości Id obiektu Microsoft.Office.Interop.PowerPoint.Shape. Poniżej podano przykładowy kod.

Presentation pres = new Presentation("Presentation.pptx");
try {
    // Pobieranie unikalnego identyfikatora kształtu w zakresie slajdu
    long officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();

} finally {
    if (pres != null) pres.dispose();
}

Ustawianie tekstu alternatywnego dla kształtu

Aspose.Slides for Android via Java umożliwia programistom ustawienie AlternateText dowolnego kształtu.
Kształty w prezentacji można rozróżniać za pomocą metody AlternativeText lub Shape Name.
Metody setAlternativeText i getAlternativeText mogą być odczytywane lub ustawiane przy użyciu Aspose.Slides oraz Microsoft PowerPoint.
Korzystając z tej metody, możesz otagować kształt i wykonywać różne operacje, takie jak usuwanie kształtu, ukrywanie kształtu lub zmiana kolejności kształtów na slajdzie.
Aby ustawić AlternateText kształtu, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj dostęp do pierwszego slajdu.
  3. Dodaj dowolny kształt do slajdu.
  4. Wykonaj pewne operacje na nowo dodanym kształcie.
  5. Przeglądaj kształty, aby znaleźć kształt.
  6. Ustaw AlternativeText.
  7. Zapisz plik na dysku.
// Utwórz instancję klasy Presentation, która reprezentuje plik PPTX
Presentation pres = new Presentation();
try {
    // Pobierz pierwszy slajd
    ISlide sld = pres.getSlides().get_Item(0);

    // Dodaj autokształt typu prostokąt
    IShape shp1 = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    IShape shp2 = sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);
    shp2.getFillFormat().setFillType(FillType.Solid);
    shp2.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        AutoShape shape = (AutoShape) sld.getShapes().get_Item(i);
        if (shape != null)
        {
            shape.setAlternativeText("User Defined");
        }
    }

    // Zapisz prezentację na dysk
    pres.save("Set_AlternativeText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Dostęp do formatów układu dla kształtu

Aspose.Slides for Android via Java udostępnia prosty interfejs API do uzyskiwania dostępu do formatów układu dla kształtu. Ten artykuł pokazuje, jak uzyskać dostęp do formatów układu.

Poniżej podano przykładowy kod.

Presentation pres = new Presentation("pres.pptx");
try {
    for (ILayoutSlide layoutSlide : pres.getLayoutSlides())
    {
        for (IShape shape : layoutSlide.getShapes())
        {
            IFillFormat fillFormats = shape.getFillFormat();
            ILineFormat lineFormats = shape.getLineFormat();
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Renderowanie kształtu jako SVG

Obecnie Aspose.Slides for Android via Java obsługuje renderowanie kształtu jako SVG. Metoda writeAsSvg (i jej przeciążenie) została dodana do klasy Shape oraz interfejsu IShape. Metoda ta umożliwia zapisanie zawartości kształtu jako pliku SVG. Poniższy fragment kodu pokazuje, jak wyeksportować kształt ze slajdu do pliku SVG.

Presentation pres = new Presentation("TestExportShapeToSvg.pptx");
try {
    FileOutputStream stream = new FileOutputStream("SingleShape.svg");
    try {
        pres.getSlides().get_Item(0).getShapes().get_Item(0).writeAsSvg(stream);
    } finally {
        if (stream != null) stream.close();
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Wyrównywanie kształtu

Aspose.Slides umożliwia wyrównywanie kształtów względem marginesów slajdu lub względem siebie nawzajem. W tym celu dodano przeciążoną metodę SlidesUtil.alignShape() . Typ wyliczeniowy ShapesAlignmentType definiuje możliwe opcje wyrównania.

Przykład 1

Poniższy kod źródłowy wyrównuje kształty o indeksach 1, 2 i 4 wzdłuż górnej krawędzi slajdu.

Presentation pres = new Presentation("example.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IShape shape1 = slide.getShapes().get_Item(1);
    IShape shape2 = slide.getShapes().get_Item(2);
    IShape shape3 = slide.getShapes().get_Item(4);
    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), new int[]
    {
        slide.getShapes().indexOf(shape1),
        slide.getShapes().indexOf(shape2),
        slide.getShapes().indexOf(shape3)
    });
} finally {
    if (pres != null) pres.dispose();
}
}

Przykład 2

Poniższy przykład pokazuje, jak wyrównać całą kolekcję kształtów względem najniższego kształtu w kolekcji.

Presentation pres = new Presentation("example.pptx");
try {
    SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0));
} finally {
    if (pres != null) pres.dispose();
}

Właściwości odbicia

W Aspose.Slides klasa ShapeFrame zapewnia kontrolę nad poziomym i pionowym odbiciem lustrzanym kształtów za pomocą właściwości flipH i flipV. Obie właściwości są typu byte, przyjmując wartość 1 oznaczającą odbicie, 0 oznaczającą brak odbicia lub -1 oznaczającą domyślne zachowanie. Wartości te są dostępne z Frame kształtu.

Aby zmodyfikować ustawienia odbicia, tworzona jest nowa instancja ShapeFrame z aktualną pozycją i rozmiarem kształtu, żądanymi wartościami flipH i flipV oraz kątem obrotu. Przypisanie tej instancji do Frame kształtu i zapisanie prezentacji zastosuje transformacje lustrzane i zapisze je w pliku wyjściowym.

Załóżmy, że mamy plik sample.pptx, w którym pierwszy slajd zawiera pojedynczy kształt z domyślnymi ustawieniami odbicia, jak pokazano poniżej.

Kształt do odbicia

Poniższy przykład kodu pobiera bieżące właściwości odbicia kształtu i odbija go zarówno poziomo, jak i pionowo.

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    // Pobierz właściwość odbicia poziomego kształtu.
    byte horizontalFlip = shape.getFrame().getFlipH();
    System.out.println("Horizontal flip: " + horizontalFlip);

    // Pobierz właściwość odbicia pionowego kształtu.
    byte verticalFlip = shape.getFrame().getFlipV();
    System.out.println("Vertical flip: " + verticalFlip);

    float x = shape.getFrame().getX();
    float y = shape.getFrame().getY();
    float width = shape.getFrame().getWidth();
    float height = shape.getFrame().getHeight();
    byte flipH = NullableBool.True; // Odbicie poziome.
    byte flipV = NullableBool.True; // Odbicie poziome.
    float rotation = shape.getFrame().getRotation();

    shape.setFrame(new ShapeFrame(x, y, width, height, flipH, flipV, rotation));

    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Wynik:

Odwrócony kształt

FAQ

Czy mogę łączyć kształty (union/intersect/subtract) na slajdzie tak jak w edytorze desktopowym?

Nie ma wbudowanego API operacji boolowskich. Można je przybliżyć, samodzielnie tworząc żądany obrys – np. obliczyć resulting geometry (przy użyciu GeometryPath) i utworzyć nowy kształt z tym konturem, opcjonalnie usuwając oryginały.

Jak mogę kontrolować kolejność warstw (z-order), aby kształt zawsze pozostawał „na wierzchu”?

Zmień kolejność wstawiania/przenoszenia w kolekcji shapes slajdu. Aby uzyskać przewidywalne rezultaty, sfinalizuj kolejność z po wykonaniu wszystkich pozostałych modyfikacji slajdu.

Czy mogę „zablokować” kształt, aby uniemożliwić użytkownikom jego edycję w PowerPoint?

Tak. Ustaw flagi ochrony na poziomie kształtu (np. blokada zaznaczania, przemieszczania, zmiany rozmiaru, edycji tekstu). W razie potrzeby, zastosuj ograniczenia na poziomie mastera lub układu. Należy zaznaczyć, że jest to ochrona na poziomie interfejsu użytkownika, a nie funkcja zabezpieczeń; dla silniejszej ochrony połącz ją z ograniczeniami na poziomie pliku, takimi jak zalecenia tylko do odczytu lub hasła.

Zastosowanie efektów kształtów w prezentacjach na Androidzie Pobieranie efektywnych właściwości kształtu z prezentacji na Androidzie