Sử dụng Hình dạng Tài liệu trong Aspose.Words cho Java
Giới thiệu về Sử dụng Hình dạng Tài liệu trong Aspose.Words cho Java
Trong hướng dẫn toàn diện này, chúng ta sẽ đi sâu vào thế giới hình dạng tài liệu trong Aspose.Words cho Java. Hình dạng là yếu tố thiết yếu khi tạo ra các tài liệu tương tác và hấp dẫn trực quan. Cho dù bạn cần thêm chú thích, nút, hình ảnh hay hình mờ, Aspose.Words for Java đều cung cấp các công cụ để thực hiện điều đó một cách hiệu quả. Hãy cùng khám phá từng bước cách sử dụng các hình dạng này bằng các ví dụ về mã nguồn.
Bắt đầu với hình dạng tài liệu
Trước khi bắt đầu viết mã, hãy thiết lập môi trường của chúng ta. Hãy đảm bảo rằng bạn đã tích hợp Aspose.Words for Java vào dự án của mình. Nếu chưa có, bạn có thể tải xuống từ trang web AsposeTải xuống Aspose.Words cho Java
Thêm hình dạng vào tài liệu
Chèn một hình dạng nhóm
MỘTGroupShape cho phép bạn nhóm nhiều hình dạng lại với nhau. Đây là cách bạn có thể tạo và chèn mộtGroupShape:
Document doc = new Document();
doc.ensureMinimum();
GroupShape groupShape = new GroupShape(doc);
Shape accentBorderShape = new Shape(doc, ShapeType.ACCENT_BORDER_CALLOUT_1);
accentBorderShape.setWidth(100.0);
accentBorderShape.setHeight(100.0);
groupShape.appendChild(accentBorderShape);
Shape actionButtonShape = new Shape(doc, ShapeType.ACTION_BUTTON_BEGINNING);
actionButtonShape.setLeft(100.0);
actionButtonShape.setWidth(100.0);
actionButtonShape.setHeight(200.0);
groupShape.appendChild(actionButtonShape);
groupShape.setWidth(200.0);
groupShape.setHeight(200.0);
groupShape.setCoordSize(new Dimension(200, 200));
DocumentBuilder builder = new DocumentBuilder(doc);
builder.insertNode(groupShape);
doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx");
Chèn hình dạng hộp văn bản
Để chèn hình dạng hộp văn bản, bạn có thể sử dụnginsertShape phương pháp như trong ví dụ dưới đây:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertShape(ShapeType.TEXT_BOX, RelativeHorizontalPosition.PAGE, 100.0,
RelativeVerticalPosition.PAGE, 100.0, 50.0, 50.0, WrapType.NONE);
shape.setRotation(30.0);
builder.writeln();
shape = builder.insertShape(ShapeType.TEXT_BOX, 50.0, 50.0);
shape.setRotation(30.0);
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.DOCX);
saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL);
doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions);
Thao tác thuộc tính hình dạng
Quản lý tỷ lệ khung hình
Bạn có thể kiểm soát xem tỷ lệ khung hình của hình có bị khóa hay không. Dưới đây là cách mở khóa tỷ lệ khung hình của hình dạng:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertImage(getImagesDir() + "Transparent background logo.png");
shape.setAspectRatioLocked(false);
doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx");
Đặt một hình dạng trong một ô bảng
Nếu bạn cần đặt một hình bên trong một ô của bảng, bạn có thể thực hiện điều này bằng mã sau:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.startTable();
builder.getRowFormat().setHeight(100.0);
builder.getRowFormat().setHeightRule(HeightRule.EXACTLY);
for (int i = 0; i < 31; i++) {
if (i != 0 && i % 7 == 0)
builder.endRow();
builder.insertCell();
builder.write("Cell contents");
}
builder.endTable();
Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT);
watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE);
watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE);
watermark.isLayoutInCell(true); // Hiển thị hình dạng bên ngoài ô của bảng nếu nó sẽ được đặt vào một ô.
watermark.setWidth(300.0);
watermark.setHeight(70.0);
watermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
watermark.setVerticalAlignment(VerticalAlignment.CENTER);
watermark.setRotation(-40);
watermark.setFillColor(Color.GRAY);
watermark.setStrokeColor(Color.GRAY);
watermark.getTextPath().setText("watermarkText");
watermark.getTextPath().setFontFamily("Arial");
watermark.setName("WaterMark_{Guid.NewGuid()}");
watermark.setWrapType(WrapType.NONE);
Run run = (Run) doc.getChildNodes(NodeType.RUN, true).get(doc.getChildNodes(NodeType.RUN, true).getCount() - 1);
builder.moveTo(run);
builder.insertNode(watermark);
doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010);
doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx");
Làm việc với Hình dạng SmartArt
Phát hiện hình dạng SmartArt
Bạn có thể phát hiện các hình dạng SmartArt trong tài liệu bằng mã sau:
Document doc = new Document("Your Directory Path" + "SmartArt.docx");
List<Shape> shapes = IterableUtils.toList(doc.getChildNodes(NodeType.SHAPE, true));
int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count();
System.out.println("The document has " + count + " shapes with SmartArt.");
Cập nhật bản vẽ SmartArt
Để cập nhật bản vẽ SmartArt trong tài liệu, hãy sử dụng mã sau:
Document doc = new Document("Your Directory Path" + "SmartArt.docx");
for (Shape shape : (Iterable<Shape>) doc.getChildNodes(NodeType.SHAPE, true)) {
if (shape.hasSmartArt())
shape.updateSmartArtDrawing();
}
Phần kết luận
Trong hướng dẫn này, chúng tôi đã khám phá thế giới hình dạng tài liệu trong Aspose.Words cho Java. Bạn đã học cách thêm nhiều hình dạng khác nhau vào tài liệu của mình, thao tác với các thuộc tính của chúng và làm việc với các hình dạng SmartArt. Với kiến thức này, bạn có thể tạo các tài liệu tương tác và hấp dẫn trực quan một cách dễ dàng.
Câu hỏi thường gặp
Aspose.Words cho Java là gì?
Aspose.Words for Java là thư viện Java cho phép các nhà phát triển tạo, sửa đổi và chuyển đổi tài liệu Word theo chương trình. Nó cung cấp nhiều tính năng và công cụ để làm việc với các tài liệu ở nhiều định dạng khác nhau.
Làm cách nào tôi có thể tải xuống Aspose.Words cho Java?
Bạn có thể tải xuống Aspose.Words cho Java từ trang web Aspose bằng cách nhấp vào liên kết sau:Tải xuống Aspose.Words cho Java
Lợi ích của việc sử dụng hình dạng tài liệu là gì?
Hình dạng tài liệu thêm các yếu tố trực quan và tính tương tác vào tài liệu của bạn, làm cho chúng trở nên hấp dẫn và giàu thông tin hơn. Với hình dạng, bạn có thể tạo chú thích, nút, hình ảnh, hình mờ, v.v., nâng cao trải nghiệm tổng thể của người dùng.
Tôi có thể tùy chỉnh sự xuất hiện của hình dạng không?
Có, bạn có thể tùy chỉnh giao diện của hình dạng bằng cách điều chỉnh các thuộc tính của chúng như kích thước, vị trí, góc xoay và màu tô. Aspose.Words for Java cung cấp các tùy chọn mở rộng để tùy chỉnh hình dạng.
Aspose.Words cho Java có tương thích với SmartArt không?
Có, Aspose.Words for Java hỗ trợ các hình dạng SmartArt, cho phép bạn làm việc với các sơ đồ và đồ họa phức tạp trong tài liệu của mình.
