Zarządzanie polami tekstowymi w prezentacjach na Androidzie

Wprowadzenie

Teksty na slajdach zazwyczaj znajdują się w polach tekstowych lub kształtach. Dlatego, aby dodać tekst do slajdu, musisz dodać pole tekstowe, a następnie umieścić w nim tekst. Aspose.Slides for Android via Java udostępnia interfejs IAutoShape umożliwiający dodanie kształtu zawierającego tekst.

Info

Aspose.Slides udostępnia również interfejs IShape umożliwiający dodawanie kształtów do slajdów. Jednak nie wszystkie kształty dodane poprzez interfejs IShape mogą zawierać tekst. Natomiast kształty dodane poprzez interfejs IAutoShape mogą zawierać tekst.

Note

Dlatego, gdy pracujesz z kształtem, do którego chcesz dodać tekst, możesz chcieć sprawdzić i potwierdzić, że został on rzutowany przy użyciu interfejsu IAutoShape. Dopiero wtedy będziesz mógł pracować z TextFrame, który jest właściwością IAutoShape. Zobacz sekcję Update Text na tej stronie.

Utworzenie pola tekstowego na slajdzie

Aby utworzyć pole tekstowe na slajdzie, wykonaj następujące kroki:

Utwórz instancję klasy Presentation.
Uzyskaj odwołanie do pierwszego slajdu w nowo utworzonej prezentacji.
Dodaj obiekt IAutoShape z ShapeType ustawionym na Rectangle w określonej pozycji na slajdzie i uzyskaj odwołanie do nowo dodanego obiektu IAutoShape.
Dodaj właściwość TextFrame do obiektu IAutoShape, która będzie zawierała tekst. W poniższym przykładzie dodaliśmy ten tekst: Aspose TextBox
Na końcu zapisz plik PPTX przy użyciu obiektu Presentation.

Ten kod Java — implementacja powyższych kroków — pokazuje, jak dodać tekst do slajdu:

// Tworzy instancję Presentation
Presentation pres = new Presentation();
try {
    // Pobiera pierwszy slajd w prezentacji
    ISlide sld = pres.getSlides().get_Item(0);

    // Dodaje AutoShape z typem ustawionym na Rectangle
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);

    // Dodaje TextFrame do prostokąta
    ashp.addTextFrame(" ");

    // Uzyskuje dostęp do ramki tekstowej
    ITextFrame txtFrame = ashp.getTextFrame();

    // Tworzy obiekt Paragraph dla ramki tekstowej
    IParagraph para = txtFrame.getParagraphs().get_Item(0);

    // Tworzy obiekt Portion dla akapitu
    IPortion portion = para.getPortions().get_Item(0);

    // Ustawia tekst
    portion.setText("Aspose TextBox");

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

Sprawdzenie, czy kształt jest polem tekstowym

Aspose.Slides udostępnia metodę isTextBox z interfejsu IAutoShape pozwalającą zbadać kształty i zidentyfikować pola tekstowe.

Text box and shape

Ten kod Java pokazuje, jak sprawdzić, czy kształt został utworzony jako pole tekstowe:

Presentation presentation = new Presentation("sample.pptx");
try {
    ForEach.shape(presentation, (shape, slide, index) -> {
        if (shape instanceof IAutoShape) {
            IAutoShape autoShape = (IAutoShape) shape;
            System.out.println(autoShape.isTextBox() ? "shape is a text box" : "shape is not a text box");
        }
    });
} finally {
    presentation.dispose();
}

Zauważ, że jeśli po prostu dodasz kształt automatyczny przy użyciu metody addAutoShape z interfejsu IShapeCollection metoda isTextBox tego kształtu zwróci false. Jednak po dodaniu tekstu do kształtu przy użyciu metody addTextFrame lub setText, właściwość isTextBox zwróci true.

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

IAutoShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
// shape1.isTextBox() zwraca false
shape1.addTextFrame("shape 1");
// shape1.isTextBox() zwraca true

IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
// shape2.isTextBox() zwraca false
shape2.getTextFrame().setText("shape 2");
// shape2.isTextBox() zwraca true

IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
// shape3.isTextBox() zwraca false
shape3.addTextFrame("");
// shape3.isTextBox() zwraca false

IAutoShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
// shape4.isTextBox() zwraca false
shape4.getTextFrame().setText("");
// shape4.isTextBox() zwraca false

Dodanie kolumn do pola tekstowego

Aspose.Slides udostępnia właściwości ColumnCount i ColumnSpacing (z interfejsu ITextFrameFormat oraz klasy TextFrameFormat), które pozwalają dodać kolumny do pól tekstowych. Możesz określić liczbę kolumn w polu tekstowym oraz ustawić odstęp w punktach pomiędzy kolumnami.

Poniższy kod w języku Java demonstruje opisaną operację:

Presentation pres = new Presentation();
try {
    // Pobiera pierwszy slajd w prezentacji
    ISlide slide = pres.getSlides().get_Item(0);

    // Dodaje AutoShape z typem ustawionym na Rectangle
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // Dodaje TextFrame do prostokąta
    aShape.addTextFrame("All these columns are limited to be within a single text container -- " +
            "you can add or delete text and the new or remaining text automatically adjusts " +
            "itself to flow within the container. You cannot have text flow from one container " +
            "to other though -- we told you PowerPoint's column options for text are limited!");

    // Pobiera format tekstu TextFrame
    ITextFrameFormat format = aShape.getTextFrame().getTextFrameFormat();

    // Określa liczbę kolumn w TextFrame
    format.setColumnCount(3);

    // Określa odstęp między kolumnami
    format.setColumnSpacing(10);

    // Zapisuje prezentację
    pres.save("ColumnCount.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Dodanie kolumn do ramki tekstowej

Aspose.Slides for Android via Java udostępnia właściwość ColumnCount (z interfejsu ITextFrameFormat), która pozwala dodać kolumny w ramkach tekstowych. Dzięki tej właściwości możesz określić preferowaną liczbę kolumn w ramce tekstowej.

Ten kod Java pokazuje, jak dodać kolumnę wewnątrz ramki tekstowej:

String outPptxFileName = "ColumnsTest.pptx";
Presentation pres = new Presentation();
try {
    IAutoShape shape1 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.getTextFrame().getTextFrameFormat();

    format.setColumnCount(2);
    shape1.getTextFrame().setText("All these columns are forced to stay within a single text container -- " +
            "you can add or delete text - and the new or remaining text automatically adjusts " +
            "itself to stay within the container. You cannot have text spill over from one container " +
            "to other, though -- because PowerPoint's column options for text are limited!");
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(Double.NaN == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test != null) test.dispose();
    }

    format.setColumnSpacing(20);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test1 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test1.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(20 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test1 != null) test1.dispose();
    }

    format.setColumnCount(3);
    format.setColumnSpacing(15);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test2 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test2.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(3 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(15 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test2 != null) test2.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Aktualizacja tekstu

Aspose.Slides pozwala zmienić lub zaktualizować tekst zawarty w polu tekstowym lub wszystkie teksty zawarte w prezentacji.

Ten kod Java demonstruje operację, w której wszystkie teksty w prezentacji są aktualizowane lub zmieniane:

Presentation pres = new Presentation("text.pptx");
try {
    for (ISlide slide : pres.getSlides())
    {
        for (IShape shape : slide.getShapes())
        {
            if (shape instanceof IAutoShape) //Sprawdza, czy kształt obsługuje ramkę tekstową (IAutoShape). 
            {
                IAutoShape autoShape = (IAutoShape)shape; 
                for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) //Iteruje przez akapity w ramce tekstowej
                {
                    for (IPortion portion : paragraph.getPortions()) //Iteruje przez każdą część w akapicie
                    {
                        portion.setText(portion.getText().replace("years", "months")); //Zmienia tekst
                        portion.getPortionFormat().setFontBold(NullableBool.True); //Zmienia formatowanie
                    }
                }
            }
        }
    }

    //Zapisuje zmodyfikowaną prezentację
    pres.save("text-changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Dodanie pola tekstowego z hiperłączem

Możesz wstawić link wewnątrz pola tekstowego. Po kliknięciu pola tekstowego użytkownicy zostaną przekierowani do otwarcia linku.

Aby dodać pole tekstowe zawierające link, wykonaj następujące kroki:

Utwórz instancję klasy Presentation.
Uzyskaj odwołanie do pierwszego slajdu w nowo utworzonej prezentacji.
Dodaj obiekt AutoShape z ShapeType ustawionym na Rectangle w określonej pozycji na slajdzie i uzyskaj odwołanie do nowo dodanego obiektu AutoShape.
Dodaj TextFrame do obiektu AutoShape, które zawiera Aspose TextBox jako domyślny tekst.
Utwórz instancję klasy IHyperlinkManager.
Przypisz obiekt IHyperlinkManager do właściwości HyperlinkClick powiązanej z wybraną częścią TextFrame.
Na końcu zapisz plik PPTX przy użyciu obiektu Presentation.

Ten kod Java — implementacja powyższych kroków — pokazuje, jak dodać pole tekstowe z hiperłączem do slajdu:

// Tworzy instancję klasy Presentation, która reprezentuje plik PPTX
Presentation pres = new Presentation();
try {
    // Pobiera pierwszy slajd w prezentacji
    ISlide slide = pres.getSlides().get_Item(0);

    // Dodaje obiekt AutoShape z typem ustawionym na Rectangle
    IShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

    // Rzutuje kształt na AutoShape
    IAutoShape pptxAutoShape = (IAutoShape)shape;

    // Uzyskuje dostęp do własności ITextFrame powiązanej z AutoShape
    pptxAutoShape.addTextFrame("");

    ITextFrame textFrame = pptxAutoShape.getTextFrame();

    // Dodaje trochę tekstu do ramki
    textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).setText("Aspose.Slides");

    // Ustawia hiperłącze dla tekstu części
    IHyperlinkManager hyperlinkManager = textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).
            getPortionFormat().getHyperlinkManager();
    hyperlinkManager.setExternalHyperlinkClick("http://www.aspose.com");

    // Zapisuje prezentację PPTX
    pres.save("hLink_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Jaka jest różnica między polem tekstowym a symbolem zastępczym tekstu podczas pracy z slajdami głównymi?

Symbol zastępczy placeholder dziedziczy styl/pozycję z mastera i może być nadpisany na układach, natomiast zwykłe pole tekstowe jest niezależnym obiektem na konkretnym slajdzie i nie zmienia się po przełączeniu układów.

Jak mogę wykonać masową wymianę tekstu w całej prezentacji bez ingerencji w teksty wewnątrz wykresów, tabel i SmartArt?

Ogranicz iterację do kształtów automatycznych posiadających ramki tekstowe i wyklucz osadzone obiekty (charts, tables, SmartArt) poprzez przeglądanie ich kolekcji oddzielnie lub pomijanie tych typów obiektów.

Zarządzaj elementami zastępczymi prezentacji na Androidzie Ulepsz swoje prezentacje za pomocą AutoFit na Androidzie