วิธีเพิ่มรูปร่างใน PowerPoint ด้วย Java
Aspose.Slides FOSS for Java รองรับการเพิ่ม AutoShapes, Tables, Connectors และ PictureFrames ไปยังสไลด์การนำเสนอ ทั้งประเภทของรูปทรงทั้งหมดจะถูกเพิ่มผ่านคอลเลกชัน slide.getShapes().
คู่มือแบบขั้นตอนต่อขั้นตอน
ขั้นตอนที่ 1: เพิ่ม Maven Dependency
<dependency>
<groupId>org.aspose.slides.foss</groupId>
<artifactId>aspose-slides-foss</artifactId>
<version>1.0.0</version>
</dependency>ขั้นตอนที่ 2: สร้างการนำเสนอ
ควรใช้ try-with-resources เสมอเพื่อจัดการทรัพยากร
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
try (Presentation prs = new Presentation()) {
ISlide slide = prs.getSlides().get(0);
// ... add shapes ...
prs.save("output.pptx", SaveFormat.PPTX);
}ขั้นตอนที่ 3: เพิ่ม AutoShape
slide.getShapes().addAutoShape(shapeType, x, y, width, height) วางรูปทรงที่ตำแหน่งและขนาดที่กำหนด (ทั้งหมดเป็นหน่วยจุด). ใช้ค่าคงที่ ShapeType เพื่อเลือกรูปทรง.
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
try (Presentation prs = new Presentation()) {
ISlide slide = prs.getSlides().get(0);
// Rectangle
IAutoShape rect = slide.getShapes().addAutoShape(
ShapeType.RECTANGLE, 50, 50, 300, 100
);
rect.addTextFrame("Rectangle shape");
// Ellipse
IAutoShape ellipse = slide.getShapes().addAutoShape(
ShapeType.ELLIPSE, 400, 50, 200, 100
);
ellipse.addTextFrame("Ellipse shape");
prs.save("autoshapes.pptx", SaveFormat.PPTX);
}ขั้นตอนที่ 4: เพิ่มตาราง
slide.getShapes().addTable(x, y, colWidths, rowHeights) สร้างตารางที่ตำแหน่งที่ระบุ ความกว้างของคอลัมน์และความสูงของแถวเป็นอาเรย์ของค่าจุด.
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
try (Presentation prs = new Presentation()) {
ISlide slide = prs.getSlides().get(0);
double[] colWidths = {150.0, 150.0, 150.0};
double[] rowHeights = {40.0, 40.0, 40.0};
ITable table = slide.getShapes().addTable(50, 200, colWidths, rowHeights);
// Set header row text
String[] headers = {"Product", "Units", "Revenue"};
for (int col = 0; col < headers.length; col++) {
table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
}
// Set data rows
String[][] rows = {
{"Widget A", "120", "$2,400"},
{"Widget B", "85", "$1,700"},
};
for (int row = 0; row < rows.length; row++) {
for (int col = 0; col < rows[row].length; col++) {
table.getRows().get(row + 1).get(col)
.getTextFrame().setText(rows[row][col]);
}
}
prs.save("table.pptx", SaveFormat.PPTX);
}ขั้นตอนที่ 5: เพิ่มคอนเนคเตอร์
คอนเนคเตอร์เชื่อมต่อสองรูปทรงให้เห็นได้ชัดเจน สร้างรูปทรงก่อน แล้วจึงเพิ่มคอนเนคเตอร์และตั้งจุดเชื่อมต่อเริ่มต้นและสิ้นสุดของมัน.
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
try (Presentation prs = new Presentation()) {
ISlide slide = prs.getSlides().get(0);
IAutoShape box1 = slide.getShapes().addAutoShape(
ShapeType.RECTANGLE, 50, 100, 150, 60
);
box1.addTextFrame("Start");
IAutoShape box2 = slide.getShapes().addAutoShape(
ShapeType.RECTANGLE, 350, 100, 150, 60
);
box2.addTextFrame("End");
IConnector conn = slide.getShapes().addConnector(
ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10
);
conn.setStartShapeConnectedTo(box1);
conn.setStartShapeConnectionSiteIndex(3); // right side of box1
conn.setEndShapeConnectedTo(box2);
conn.setEndShapeConnectionSiteIndex(1); // left side of box2
prs.save("connector.pptx", SaveFormat.PPTX);
}ดัชนีจุดเชื่อมต่อจะถูกกำหนดเป็นเลข 0‑3 สำหรับสี่เหลี่ยมผืนผ้า: ด้านบน=0, ด้านซ้าย=1, ด้านล่าง=2, ด้านขวา=3.
ขั้นตอนที่ 6: เพิ่มกรอบรูปภาพ
ฝังรูปภาพและเพิ่มลงในสไลด์เป็น PictureFrame. อ่านไบต์ของรูปภาพก่อน, เพิ่มลงในคอลเลกชันรูปภาพของงานนำเสนอ, แล้วสร้างเฟรม.
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
import java.nio.file.Files;
import java.nio.file.Paths;
try (Presentation prs = new Presentation()) {
byte[] imageData = Files.readAllBytes(Paths.get("logo.png"));
IPPImage image = prs.getImages().addImage(imageData);
ISlide slide = prs.getSlides().get(0);
slide.getShapes().addPictureFrame(
ShapeType.RECTANGLE, // bounding shape type
50, 50, // x, y in points
200, 150, // width, height in points
image
);
prs.save("with-image.pptx", SaveFormat.PPTX);
}ปัญหาทั่วไปและการแก้ไข
รูปร่างปรากฏอยู่นอกพื้นที่สไลด์ที่มองเห็นได้
สไลด์มีขนาด 720 x 540 จุดโดยค่าเริ่มต้น. ค่าของ x หรือ y ที่เกินขอบเขตเหล่านี้จะทำให้รูปร่างอยู่นอกสไลด์. รักษา x < 720 และ y < 540, และตรวจสอบให้แน่ใจว่า x + width <= 720 และ y + height <= 540.
NullPointerException เมื่ออ่านข้อความรูปทรง
addAutoShape() คืนค่าอ็อบเจ็กต์รูปทรงโดยตรง หากคุณเห็น null ให้ตรวจสอบว่าคุณไม่ได้ละทิ้งค่าที่คืนกลับ นอกจากนี้ให้ตรวจสอบว่า getTextFrame() ไม่เป็น null ก่อนอ่านข้อความ.
ข้อความในเซลล์ตารางเป็นค่าว่างหลังจากการกำหนดค่า
วิธีที่ถูกต้องคือ .getTextFrame().setText(value). เข้าถึงเซลล์เป็น table.getRows().get(rowIndex).get(colIndex).getTextFrame().setText("value").
คำถามที่พบบ่อย
ฉันสามารถเพิ่มรูปทรงได้กี่รูปในสไลด์?
ไม่มีขีดจำกัดที่กำหนดโดยไลบรารี. ขีดจำกัดเชิงปฏิบัติจะแปรตามขนาดไฟล์และความสามารถในการเรนเดอร์ของโปรแกรมดู PPTX เป้าหมายของคุณ.
ฉันสามารถเปลี่ยนตำแหน่งของรูปทรงหลังจากเพิ่มแล้วได้หรือไม่?
ใช่. วัตถุ shape ที่ส่งกลับโดย addAutoShape() มีคุณสมบัติ position และ size ผ่าน getShapeFrame().
รองรับแผนภูมิหรือไม่?
ไม่มี. แผนภูมิ, SmartArt และวัตถุ OLE ไม่ได้ถูกนำมาใช้ในรุ่นนี้และทำให้เกิด UnsupportedOperationException.