Hantera textrutor i presentationer på Android
Introduktion
I Aspose.Slides för Android via Java lagras bildtext i textramar som tillhör former. Gränssnittet IAutoShape representerar den vanligaste textbärande formen och exponerar dess text via metoden IAutoShape.getTextFrame .
Note
Varje autoform implementerar IShape, men inte varje form är en autoform eller stöder en textram. När du bearbetar en befintlig presentation, kontrollera att en form implementerar IAutoShape innan du får åtkomst till dess text.Skapa en textruta på en bild
För att skapa en textruta, lägg till en autoform på en bild, lägg till text i dess textram och spara presentationen. Följande exempel skapar en rektangulär textruta:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 300, 50);
textBox.addTextFrame("Aspose TextBox");
presentation.save("TextBox.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Koordinaterna och dimensionerna som skickas till IShapeCollection.addAutoShape mäts i punkter. IAutoShape.addTextFrame initierar textramen med den angivna texten.
Kontrollera om en form är en textruta
Använd metoden IAutoShape.isTextBox för att avgöra om en autoform behandlas som en textruta. Detta är användbart när en presentation innehåller både textbärande och enbart grafiska autoformer.
Följande exempel undersöker varje autoform i en presentation:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 120, 40);
textBox.addTextFrame("Text box");
slide.getShapes().addAutoShape(ShapeType.Ellipse, 150, 10, 40, 40);
for (ISlide currentSlide : presentation.getSlides()) {
for (IShape shape : currentSlide.getShapes()) {
if (shape instanceof IAutoShape) {
IAutoShape autoShape = (IAutoShape) shape;
System.out.println(autoShape.isTextBox() ? "The shape is a text box." : "The shape is not a text box.");
}
}
}
} finally {
presentation.dispose();
}
En ny tillagd autoform betraktas inte som en textruta förrän den innehåller icke-tom text. Du kan tillhandahålla den texten via IAutoShape.addTextFrame eller ITextFrame.setText. Att lägga till eller tilldela en tom sträng får IAutoShape.isTextBox att returnera false:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
shape1.addTextFrame("Shape 1");
System.out.println(shape1.isTextBox());
IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 70, 100, 40);
shape2.getTextFrame().setText("Shape 2");
System.out.println(shape2.isTextBox());
IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 130, 100, 40);
shape3.addTextFrame("");
System.out.println(shape3.isTextBox());
IAutoShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 190, 100, 40);
shape4.getTextFrame().setText("");
System.out.println(shape4.isTextBox());
} finally {
presentation.dispose();
}
De två första anropen skriver ut true; de två sista skriver ut false.
Hitta formen som äger en textram
Generisk textbearbetningskod kan få ett ITextFrame utan att veta vilket presentationsobjekt som innehåller det. Använd den skrivskyddade metoden ITextFrame.getParentShape för att navigera tillbaka till dess ägande IShape.
För en textram som ägs av en autoform eller en annan textbärande form, returnerar ITextFrame.getParentShape ägaren och ITextFrame.getParentCell returnerar null. Kontrollera det returnerade värdet innan du åtkommer det. För att identifiera både form‑ och tabellcellsägare, inklusive former som är associerade med SmartArt‑noder, se Search and Replace Text.
Lägg till kolumner i en textruta
Metoden ITextFrameFormat.setColumnCount delar textramen i kolumner, medan ITextFrameFormat.setColumnSpacing ställer in avståndet mellan kolumner i punkter. Båda inställningarna tillhör ITextFrameFormat och kan ändras via textramen för en befintlig textruta. Text flödar om mellan kolumner inom samma form; den fortsätter inte i en annan form.
Följande exempel skapar en textruta med tre kolumner och 10 punkters avstånd mellan kolumnerna, sparar presentationen och läser de lagrade inställningarna från utdatafilen:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 200);
textBox.addTextFrame("This text is distributed automatically across all columns in the text box.");
ITextFrameFormat textFrameFormat = textBox.getTextFrame().getTextFrameFormat();
textFrameFormat.setColumnCount(3);
textFrameFormat.setColumnSpacing(10);
presentation.save("TextBoxColumns.pptx", SaveFormat.Pptx);
Presentation savedPresentation = new Presentation("TextBoxColumns.pptx");
try {
IAutoShape savedTextBox = (IAutoShape) savedPresentation.getSlides().get_Item(0).getShapes().get_Item(0);
ITextFrameFormat savedFormat = savedTextBox.getTextFrame().getTextFrameFormat();
System.out.println("Columns: " + savedFormat.getColumnCount() + "; spacing: " + savedFormat.getColumnSpacing() + " points");
} finally {
savedPresentation.dispose();
}
} finally {
presentation.dispose();
}
Extrahera text från enskilda kolumner
Använd ITextFrame.splitTextByColumns för att hämta texten som tilldelats varje visuellt kolumn i en befintlig textram. Metoden returnerar en sträng för varje kolumn, i kolumnbaserad läsordning. En enkolumns textram ger en array med ett element, och en tom kolumn representeras av en tom sträng. Strängarna innehåller enbart klartext; formatering på delnivå bevaras inte.
Det är användbart när du behöver:
- Extrahera text samtidigt som dess kolumnbaserade läsordning bevaras.
- Indexera eller jämföra innehållet i bildspel med flera kolumner.
- Exportera varje kolumn till en separat fil, databasfält eller annan destination.
- Undersök hur text omfördelas efter att kolumnantalet ändrats med ITextFrameFormat.setColumnCount, avståndet med ITextFrameFormat.setColumnSpacing, teckensnittet eller textramens storlek.
Metoden rapporterar den text som fördelas inom den aktuella ITextFrame; den flödar inte automatiskt text mellan separata former eller textrutor. Kolumndistribution kan bero på tillgängliga teckensnitt och andra textlayoutinställningar, så se till att de erforderliga teckensnitten är tillgängliga när konsekventa resultat är viktiga.
Följande exempel läser in en presentation, hittar den första autoformen med flera kolumner och en textram, läser dess konfigurerade kolumnantal och skriver texten från varje kolumn till en separat fil. Former som inte har en textram hoppas över.
import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
Presentation presentation = new Presentation("MultiColumnText.pptx");
try {
IAutoShape textBox = null;
for (IShape shape : presentation.getSlides().get_Item(0).getShapes()) {
if (shape instanceof IAutoShape) {
IAutoShape autoShape = (IAutoShape) shape;
if (autoShape.getTextFrame() != null) {
int columnCount = autoShape.getTextFrame().getTextFrameFormat().getColumnCount();
if (columnCount > 1) {
textBox = autoShape;
break;
}
}
}
}
if (textBox == null) {
System.out.println("No multi-column text frame was found.");
} else {
ITextFrame textFrame = textBox.getTextFrame();
int configuredColumnCount = textFrame.getTextFrameFormat().getColumnCount();
String[] columnTexts = textFrame.splitTextByColumns();
System.out.println("Configured columns: " + configuredColumnCount);
for (int columnIndex = 0; columnIndex < columnTexts.length; columnIndex++) {
int columnNumber = columnIndex + 1;
String columnText = columnTexts[columnIndex];
System.out.println("Column " + columnNumber + ": " + columnText);
String outputPath = "Column-" + columnNumber + ".txt";
byte[] textBytes = columnText.getBytes(StandardCharsets.UTF_8);
try (FileOutputStream outputStream = new FileOutputStream(outputPath)) {
outputStream.write(textBytes);
} catch (IOException exception) {
System.out.println("Could not write column " + columnNumber + ": " + exception.getMessage());
}
}
}
} finally {
presentation.dispose();
}
Uppdatera text
För att uppdatera text i hela en presentation, iterera genom bilderna och formerna, välj autoformer och redigera sedan deras textdelar. Att arbeta på delnivå låter dig ändra både text och teckenformat.
Följande exempel ersätter varje förekomst av years med months i autoformstext och gör varje påverkad del fetstil:
import com.aspose.slides.*;
Presentation presentation = new Presentation("Text.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
for (IShape shape : slide.getShapes()) {
if (!(shape instanceof IAutoShape)) {
continue;
}
IAutoShape autoShape = (IAutoShape) shape;
ITextFrame textFrame = autoShape.getTextFrame();
if (textFrame == null) {
continue;
}
for (IParagraph paragraph : textFrame.getParagraphs()) {
for (IPortion portion : paragraph.getPortions()) {
String text = portion.getText();
if (text != null && text.contains("years")) {
portion.setText(text.replace("years", "months"));
portion.getPortionFormat().setFontBold(NullableBool.True);
}
}
}
}
}
presentation.save("TextChanged.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Denna genomgång uppdaterar endast text i autoformer. Text som lagras i tabeller, diagram, SmartArt eller grupperade former kräver genomgång av dessa objekts egna samlingar.
Lägg till en textruta med en hyperlänk
En hyperlänk kan tilldelas en specifik textdel, så endast den texten fungerar som den klickbara länken. Använd IHyperlinkManager.setExternalHyperlinkClick för att koppla delen till en extern URL.
Följande exempel skapar länkad text och sparar den i en presentation:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 200, 50);
textBox.addTextFrame("Aspose.Slides");
IPortion textPortion = textBox.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
textPortion.getPortionFormat().getHyperlinkManager().setExternalHyperlinkClick("https://www.aspose.com/");
presentation.save("Hyperlink.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
FAQ
Vad är skillnaden mellan en textruta och en textplatshållare på en master‑ eller layout‑bild?
En placeholder kan ärva sin position och formatering från en master‑slide eller en layout‑slide. En vanlig textruta är en oberoende form på bilden där den skapades och får inte placeholder‑beteende när layouten ändras.
Hur kan jag ersätta text utan att ändra text i diagram, tabeller eller SmartArt?
Begränsa traverseringen till former som implementerar IAutoShape, som visas i exemplet Uppdatera text. Diagram, tabeller och SmartArt lagrar text i sina egna objektmodeller, så de ändras inte av den loopen.