Quản lý OLE trong Bài thuyết trình trên Android
Giới thiệu
Xem xét một biểu đồ được tạo trong MS Excel. Biểu đồ sau đó được đặt vào một slide PowerPoint. Biểu đồ Excel đó được coi là một đối tượng OLE.
- Đối tượng OLE có thể xuất hiện dưới dạng biểu tượng. Trong trường hợp này, khi bạn nhấp đúp vào biểu tượng, biểu đồ sẽ được mở trong ứng dụng liên kết (Excel), hoặc bạn sẽ được yêu cầu chọn một ứng dụng để mở hoặc chỉnh sửa đối tượng.
- Đối tượng OLE có thể hiển thị nội dung thực tế của nó, chẳng hạn như nội dung của một biểu đồ. Trong trường hợp này, biểu đồ được kích hoạt trong PowerPoint, giao diện biểu đồ tải lên và bạn có thể chỉnh sửa dữ liệu của biểu đồ trong PowerPoint.
Aspose.Slides for Android via Java cho phép bạn chèn OLE Objects vào các slide dưới dạng khung đối tượng OLE (OleObjectFrame).
Thêm Khung Đối Tượng OLE vào Slide
Giả sử bạn đã tạo một biểu đồ trong Microsoft Excel và muốn nhúng nó vào một slide dưới dạng khung đối tượng OLE bằng Aspose.Slides for Android via Java, bạn có thể làm như sau:
- Tạo một thể hiện của lớp Presentation.
- Lấy tham chiếu của slide thông qua chỉ số của nó.
- Đọc tệp Excel dưới dạng mảng byte.
- Thêm OleObjectFrame vào slide, chứa mảng byte và các thông tin khác về đối tượng OLE.
- Ghi bài thuyết trình đã chỉnh sửa dưới dạng tệp PPTX.
Trong ví dụ dưới đây, chúng tôi đã thêm một biểu đồ từ tệp Excel vào slide dưới dạng khung đối tượng OLE bằng Aspose.Slides for Android via Java.
Lưu ý rằng constructor của OleEmbeddedDataInfo nhận một phần mở rộng đối tượng có thể nhúng làm tham số thứ hai. Phần mở rộng này cho phép PowerPoint giải thích đúng loại tệp và chọn ứng dụng phù hợp để mở đối tượng OLE này.
Presentation presentation = new Presentation();
SizeF slideSize = presentation.getSlideSize().getSize();
ISlide slide = presentation.getSlides().get_Item(0);
// Chuẩn bị dữ liệu cho đối tượng OLE.
File file = new File("book.xlsx");
byte fileData[] = new byte[(int) file.length()];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
DataInputStream dis = new DataInputStream(bis);
dis.readFully(fileData);
IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileData, "xlsx");
// Thêm khung đối tượng OLE vào slide.
slide.getShapes().addOleObjectFrame(0, 0, slideSize.getWidth(), slideSize.getHeight(), dataInfo);
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Thêm Khung Đối Tượng OLE Liên Kết
Aspose.Slides for Android via Java cho phép bạn thêm một OleObjectFrame mà không nhúng dữ liệu mà chỉ có liên kết tới tệp.
Mã Java này cho thấy cách thêm một OleObjectFrame với tệp Excel được liên kết vào slide:
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
// Thêm khung đối tượng OLE với tệp Excel được liên kết.
slide.getShapes().addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Truy cập Khung Đối Tượng OLE
Nếu một đối tượng OLE đã được nhúng trong slide, bạn có thể dễ dàng tìm hoặc truy cập nó theo cách sau:
- Tải một bài thuyết trình có đối tượng OLE được nhúng bằng cách tạo một thể hiện của lớp Presentation.
- Lấy tham chiếu của slide bằng cách sử dụng chỉ số của nó.
- Truy cập hình dạng OleObjectFrame. Trong ví dụ của chúng tôi, chúng tôi sử dụng PPTX đã tạo trước đó, chỉ có một hình dạng trên slide đầu tiên. Sau đó chúng tôi ép kiểu đối tượng đó thành IOleObjectFrame. Đây là khung đối tượng OLE mong muốn để được truy cập.
- Khi đã truy cập được khung đối tượng OLE, bạn có thể thực hiện bất kỳ thao tác nào trên nó.
Trong ví dụ dưới đây, một khung đối tượng OLE (đối tượng biểu đồ Excel được nhúng trong slide) và dữ liệu tệp của nó được truy cập.
Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);
if (shape instanceof IOleObjectFrame) {
IOleObjectFrame oleFrame = (IOleObjectFrame) shape;
// Lấy dữ liệu tệp được nhúng.
byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();
// Lấy phần mở rộng của tệp được nhúng.
String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();
// ...
}
Truy cập Thuộc Tính Khung Đối Tượng OLE Liên Kết
Aspose.Slides cho phép bạn truy cập các thuộc tính của khung đối tượng OLE liên kết.
Mã Java này cho thấy cách kiểm tra xem một đối tượng OLE có được liên kết hay không và sau đó lấy đường dẫn tới tệp được liên kết:
Presentation presentation = new Presentation("sample.ppt");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);
if (shape instanceof IOleObjectFrame) {
IOleObjectFrame oleFrame = (IOleObjectFrame) shape;
// Kiểm tra xem đối tượng OLE có được liên kết hay không.
if (oleFrame.isObjectLink()) {
// In ra đường dẫn đầy đủ tới tệp được liên kết.
System.out.println("OLE object frame is linked to: " + oleFrame.getLinkPathLong());
// In ra đường dẫn tương đối tới tệp được liên kết nếu có.
// Chỉ các bản trình bày PPT mới có thể chứa đường dẫn tương đối.
if (oleFrame.getLinkPathRelative() != null && !oleFrame.getLinkPathRelative().isEmpty()) {
System.out.println("OLE object frame relative path: " + oleFrame.getLinkPathRelative());
}
}
}
presentation.dispose();
Thay đổi Dữ liệu Đối tượng OLE
Nếu một đối tượng OLE đã được nhúng trong slide, bạn có thể dễ dàng truy cập đối tượng đó và sửa đổi dữ liệu của nó theo cách sau:
- Tải một bài thuyết trình có đối tượng OLE được nhúng bằng cách tạo một thể hiện của lớp Presentation.
- Lấy tham chiếu của slide thông qua chỉ số của nó.
- Truy cập hình dạng khung đối tượng OLE. Trong ví dụ của chúng tôi, chúng tôi sử dụng PPTX đã tạo trước đó, chỉ có một hình dạng trên slide đầu tiên. Sau đó chúng tôi ép kiểu đối tượng đó thành IOleObjectFrame. Đây là khung đối tượng OLE mong muốn để được truy cập.
- Khi đã truy cập được khung đối tượng OLE, bạn có thể thực hiện bất kỳ thao tác nào trên nó.
- Tạo một đối tượng
Workbookvà truy cập dữ liệu OLE. - Truy cập
Worksheetmong muốn và chỉnh sửa dữ liệu. - Lưu
Workbookđã cập nhật vào một luồng. - Thay đổi dữ liệu đối tượng OLE từ luồng.
Trong ví dụ dưới đây, một khung đối tượng OLE (đối tượng biểu đồ Excel được nhúng trong slide) được truy cập và dữ liệu tệp của nó được sửa đổi để cập nhật dữ liệu biểu đồ.
Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);
if (shape instanceof IOleObjectFrame) {
IOleObjectFrame oleFrame = (IOleObjectFrame) shape;
ByteArrayInputStream oleStream = new ByteArrayInputStream(oleFrame.getEmbeddedData().getEmbeddedFileData());
// Đọc dữ liệu đối tượng OLE dưới dạng đối tượng Workbook.
Workbook workbook = new Workbook(oleStream);
ByteArrayOutputStream newOleStream = new ByteArrayOutputStream();
// Sửa đổi dữ liệu workbook.
workbook.getWorksheets().get(0).getCells().get(0, 4).putValue("E");
workbook.getWorksheets().get(0).getCells().get(1, 4).putValue(12);
workbook.getWorksheets().get(0).getCells().get(2, 4).putValue(14);
workbook.getWorksheets().get(0).getCells().get(3, 4).putValue(15);
OoxmlSaveOptions fileOptions = new OoxmlSaveOptions(com.aspose.cells.SaveFormat.XLSX);
workbook.save(newOleStream, fileOptions);
// Thay đổi dữ liệu đối tượng khung OLE.
IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(newOleStream.toByteArray(), oleFrame.getEmbeddedData().getEmbeddedFileExtension());
oleFrame.setEmbeddedData(newData);
}
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Nhúng Các Loại Tệp Khác vào Slide
Ngoài biểu đồ Excel, Aspose.Slides for Android via Java cho phép bạn nhúng các loại tệp khác vào slide. Ví dụ, bạn có thể chèn các tệp HTML, PDF và ZIP dưới dạng đối tượng. Khi người dùng nhấp đúp vào đối tượng đã chèn, nó sẽ tự động mở trong chương trình liên quan, hoặc người dùng sẽ được yêu cầu chọn một chương trình phù hợp để mở.
Mã Java này cho thấy cách nhúng HTML và ZIP vào slide:
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
File fileHtml = new File("sample.html");
byte htmlData[] = new byte[(int) fileHtml.length()];
BufferedInputStream bisHtml = new BufferedInputStream(new FileInputStream(fileHtml));
DataInputStream disHtml = new DataInputStream(bisHtml);
disHtml.readFully(htmlData);
IOleEmbeddedDataInfo htmlDataInfo = new OleEmbeddedDataInfo(htmlData, "html");
IOleObjectFrame htmlOleFrame = slide.getShapes().addOleObjectFrame(150, 120, 50, 50, htmlDataInfo);
htmlOleFrame.setObjectIcon(true);
File fileZip = new File("sample.zip");
byte zipData[] = new byte[(int) fileZip.length()];
BufferedInputStream bisZip = new BufferedInputStream(new FileInputStream(fileZip));
DataInputStream disZip = new DataInputStream(bisZip);
disZip.readFully(zipData);
IOleEmbeddedDataInfo zipDataInfo = new OleEmbeddedDataInfo(zipData, "zip");
IOleObjectFrame zipOleFrame = slide.getShapes().addOleObjectFrame(150, 220, 50, 50, zipDataInfo);
zipOleFrame.setObjectIcon(true);
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Đặt Kiểu Tệp cho Đối Tượng Được Nhúng
Khi làm việc với các bài thuyết trình, bạn có thể cần thay thế các đối tượng OLE cũ bằng các đối tượng mới hoặc thay thế một đối tượng OLE không được hỗ trợ bằng một đối tượng được hỗ trợ. Aspose.Slides for Android via Java cho phép bạn đặt kiểu tệp cho một đối tượng được nhúng, cho phép cập nhật dữ liệu khung OLE hoặc phần mở rộng của nó.
Mã Java này cho thấy cách đặt kiểu tệp cho một đối tượng OLE được nhúng thành zip:
Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IOleObjectFrame oleFrame = (IOleObjectFrame) slide.getShapes().get_Item(0);
String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();
byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();
System.out.println("Current embedded file extension is: " + fileExtension);
// Change the file type to ZIP.
oleFrame.setEmbeddedData(new OleEmbeddedDataInfo(fileData, "zip"));
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Đặt Hình Ảnh Biểu Tượng và Tiêu Đề cho Đối Tượng Được Nhúng
Sau khi nhúng một đối tượng OLE, một bản xem trước gồm hình ảnh biểu tượng được thêm tự động. Bản xem trước này là những gì người dùng thấy trước khi truy cập hoặc mở đối tượng OLE. Nếu bạn muốn sử dụng một hình ảnh và văn bản cụ thể làm phần tử trong bản xem trước, bạn có thể đặt hình ảnh biểu tượng và tiêu đề bằng Aspose.Slides for Android via Java.
Mã Java này cho thấy cách đặt hình ảnh biểu tượng và tiêu đề cho một đối tượng được nhúng:
Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IOleObjectFrame oleFrame = (IOleObjectFrame) slide.getShapes().get_Item(0);
// Thêm hình ảnh vào tài nguyên của bài thuyết trình.
File file = new File("image.png");
byte imageData[] = new byte[(int) file.length()];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
DataInputStream dis = new DataInputStream(bis);
dis.readFully(imageData);
IPPImage oleImage = presentation.getImages().addImage(imageData);
// Đặt tiêu đề và hình ảnh cho bản xem trước OLE.
oleFrame.setSubstitutePictureTitle("My title");
oleFrame.getSubstitutePictureFormat().getPicture().setImage(oleImage);
oleFrame.setObjectIcon(true);
presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();
Ngăn Khung Đối Tượng OLE bị Thay Đổi Kích Thước và Vị Trí
Sau khi bạn thêm một đối tượng OLE liên kết vào slide của bài thuyết trình, khi mở bài thuyết trình trong PowerPoint, bạn có thể thấy một thông báo yêu cầu cập nhật các liên kết. Nhấn nút “Update Links” có thể thay đổi kích thước và vị trí của khung đối tượng OLE vì PowerPoint cập nhật dữ liệu từ đối tượng OLE liên kết và làm mới bản xem trước của đối tượng. Để ngăn PowerPoint hiển thị thông báo cập nhật dữ liệu đối tượng, đặt phương thức setUpdateAutomatic của giao diện IOleObjectFrame thành false:
oleFrame.setUpdateAutomatic(false);
Trích xuất Các Tệp Được Nhúng
Aspose.Slides for Android via Java cho phép bạn trích xuất các tệp được nhúng trong slide dưới dạng đối tượng OLE theo cách sau:
- Tạo một thể hiện của lớp Presentation chứa các đối tượng OLE bạn muốn trích xuất.
- Lặp qua tất cả các hình dạng trong bài thuyết trình và truy cập các hình dạng OLEObjectFrame.
- Truy cập dữ liệu của các tệp được nhúng từ khung đối tượng OLE và ghi chúng ra đĩa.
Mã Java này cho thấy cách trích xuất các tệp được nhúng trong slide dưới dạng đối tượng OLE:
Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
for (int index = 0; index < slide.getShapes().size(); index++) {
IShape shape = slide.getShapes().get_Item(index);
if (shape instanceof IOleObjectFrame) {
IOleObjectFrame oleFrame = (IOleObjectFrame) shape;
byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();
String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();
FileOutputStream fos = new FileOutputStream(new File("OLE_object_" + index + fileExtension));
fos.write(fileData);
fos.close();
}
}
presentation.dispose();
FAQ
Nội dung OLE có được hiển thị khi xuất slide sang PDF/hình ảnh không?
Những gì hiển thị trên slide sẽ được render—biểu tượng/hình ảnh thay thế (bản xem trước). Nội dung OLE “sống” không được thực thi trong quá trình render. Nếu cần, hãy đặt hình ảnh xem trước của riêng bạn để đảm bảo diện mạo mong muốn trong PDF đã xuất.
Làm sao tôi có thể khóa một đối tượng OLE trên slide để người dùng không thể di chuyển/chỉnh sửa nó trong PowerPoint?
Khóa hình dạng: Aspose.Slides cung cấp các khóa ở mức hình dạng. Đây không phải là mã hoá, nhưng nó ngăn ngừa việc chỉnh sửa và di chuyển vô tình.
Tại sao một đối tượng Excel liên kết lại “nhảy” hoặc thay đổi kích thước khi tôi mở bài thuyết trình?
PowerPoint có thể làm mới bản xem trước của OLE liên kết. Để có diện mạo ổn định, hãy tuân theo các thực tiễn ở Working Solution for Worksheet Resizing—hoặc điều chỉnh khung cho vừa với phạm vi, hoặc thu phóng phạm vi vào khung cố định và đặt hình ảnh thay thế phù hợp.
Các đường dẫn tương đối cho các đối tượng OLE liên kết có được giữ lại trong định dạng PPTX không?
Trong PPTX, thông tin “đường dẫn tương đối” không có—chỉ có đường dẫn đầy đủ. Đường dẫn tương đối chỉ xuất hiện trong định dạng PPT cũ. Để đảm bảo khả năng di chuyển, bạn nên ưu tiên sử dụng các đường dẫn tuyệt đối đáng tin cậy/URI có thể truy cập hoặc nhúng.