Truy xuất và Cập nhật Thuộc tính chế độ xem Bản trình chiếu trong JavaScript

Trang này nói về điều gì

Khám phá Aspose.Slides cho Node.js thông qua các thuộc tính chế độ xem Java để tùy chỉnh các định dạng PPT, PPTX và ODP—điều chỉnh bố cục, mức thu phóng và cài đặt hiển thị.

Giới thiệu

Chế độ xem bình thường gồm ba khu vực nội dung: bản trình chiếu, một khu vực nội dung bên và một khu vực nội dung phía dưới. Các thuộc tính liên quan đến vị trí của các khu vực nội dung khác nhau. Thông tin này cho phép ứng dụng lưu trạng thái xem vào tệp, để khi mở lại, chế độ xem sẽ ở cùng trạng thái như khi bản trình chiếu được lưu lần cuối.

Phương thức ViewProperties.getNormalViewProperties đã được thêm vào để cung cấp quyền truy cập vào các thuộc tính chế độ xem bình thường của bản trình chiếu.

Các lớp NormalViewProperties, NormalViewRestoredProperties và các lớp kế thừa của chúng, SplitterBarStateType enum đã được thêm.

Về NormalViewProperties

Biểu diễn các thuộc tính chế độ xem bình thường.

Các phương thức getShowOutlineIcons và setShowOutlineIcons chỉ định liệu ứng dụng có hiển thị biểu tượng khi hiển thị nội dung đề cương trong bất kỳ khu vực nội dung nào của chế độ xem bình thường hay không.

Các phương thức getSnapVerticalSplitter và setSnapVerticalSplitter chỉ định liệu thanh chia dọc có tự động thu gọn khi khu vực bên đủ nhỏ.

Thuộc tính getPreferSingleView và setPreferSingleView chỉ định liệu người dùng ưu tiên xem một vùng nội dung duy nhất trên toàn cửa sổ so với chế độ xem bình thường tiêu chuẩn với ba khu vực nội dung. Nếu bật, ứng dụng có thể chọn hiển thị một trong các khu vực nội dung trên toàn cửa sổ.

Các phương thức getVerticalBarState và getHorizontalBarState xác định trạng thái mà thanh chia dọc hoặc ngang sẽ hiển thị. Thanh chia dọc tách bản trình chiếu khỏi khu vực nội dung bên, thanh chia ngang tách bản trình chiếu khỏi khu vực nội dung dưới. Các giá trị có thể là: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized và SplitterBarStateType.Restored.

Các phương thức getRestoredLeft và getRestoredTop xác định kích thước của khu vực bản trình chiếu phía trên hoặc bên của chế độ xem bình thường, khi giá trị SplitterBarStateType.Restored được áp dụng cho getVerticalBarState và getHorizontalBarState tương ứng.

Về Restoring NormalViewProperties

Xác định kích thước của khu vực bản trình chiếu (chiều rộng khi là con của getRestoredTop, chiều cao khi là con của getRestoredLeft) của chế độ xem bình thường, khi khu vực có kích thước khôi phục biến đổi (không thu gọn và không phóng to).

Phương thức getDimensionSize xác định kích thước của khu vực bản trình chiếu (chiều rộng khi là con của restoredTop, chiều cao khi là con của restoredLeft).

Phương thức getAutoAdjust xác định liệu kích thước của khu vực nội dung bên có nên tự điều chỉnh để bù cho kích thước mới khi thay đổi kích thước cửa sổ chứa chế độ xem trong ứng dụng hay không.

Một ví dụ dưới đây cho thấy cách truy cập các thuộc tính ViewProperties.getNormalViewProperties cho một bản trình chiếu.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var pres = new aspose.slides.Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(aspose.slides.SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(aspose.slides.SplitterBarStateType.Maximized);

    // Khôi phục các thuộc tính chế độ xem của bản trình chiếu
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
    pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);
    pres.save("presentation_normal_view_state.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Đặt Giá Trị Thu Phóng Mặc Định

Aspose.Slides for Node.js via Java hiện hỗ trợ đặt giá trị thu phóng mặc định cho bản trình chiếu sao cho khi mở bản trình chiếu, mức thu phóng đã được thiết lập sẵn. Điều này có thể thực hiện bằng cách đặt ViewProperties của một bản trình chiếu. Các phương thức getSlideViewProperties và getNotesViewProperties có thể được thiết lập bằng mã. Trong chủ đề này, chúng ta sẽ xem qua một ví dụ về cách đặt View Properties của Presentation trong Aspose.Slides.

Để đặt các thuộc tính chế độ xem, hãy thực hiện các bước sau:

Tạo một thể hiện của lớp Presentation.
Đặt View Properties của Presentation.
Ghi bản trình chiếu thành tệp PPTX.
Trong ví dụ dưới đây, chúng tôi đã đặt giá trị thu phóng cho chế độ xem bản trình chiếu cũng như chế độ xem ghi chú.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation();
try {
    // Đặt các thuộc tính chế độ xem của bản trình chiếu
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // Giá trị thu phóng tính bằng phần trăm cho chế độ xem slide
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // Giá trị thu phóng tính bằng phần trăm cho chế độ xem ghi chú
    presentation.save("Zoom_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Đặt Khoảng Cách Lưới

Sử dụng Presentation.getViewProperties để truy cập cài đặt chế độ xem trên toàn bộ bản trình chiếu. Các phương thức ViewProperties.getGridSpacing và ViewProperties.setGridSpacing đọc hoặc thay đổi khoảng cách của lưới chỉnh sửa cơ bản. Cài đặt này áp dụng cho toàn bộ bản trình chiếu, không phải cho một slide riêng lẻ. Khoảng cách lưới được tính bằng điểm, trong đó 72 điểm bằng một inch. Sử dụng giá trị dương, theo yêu cầu của tài liệu API.

Ví dụ sau mở một tệp demo.pptx hiện có, in ra khoảng cách lưới hiện tại, đặt khoảng cách một phần tư inch và lưu kết quả.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation("demo.pptx");
try {
    var gridSpacing = presentation.getViewProperties().getGridSpacing();
    console.log("Current grid spacing: " + gridSpacing + " points");

    presentation.getViewProperties().setGridSpacing(18);
    presentation.save("grid-spacing.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Lưới khác với drawing guides. Khoảng cách lưới kiểm soát một khoảng đều đặn, trong khi các hướng dẫn vẽ là các đường thẳng ngang hoặc dọc được đặt vị trí riêng lẻ. Thêm, di chuyển hoặc xoá các hướng dẫn vẽ không thay đổi khoảng cách lưới.

Cả lưới và các hướng dẫn vẽ đều là công cụ hỗ trợ chỉnh sửa. Chúng không được hiển thị như nội dung slide trong PDF, hình ảnh, SVG hoặc bản trình chiếu. Lưu khoảng cách lưới không đảm bảo một trình soạn thảo sẽ hiển thị lưới: tính khả dụng còn phụ thuộc vào cài đặt của người xem hoặc trình soạn thảo.

Hiển Thị Hoặc Ẩn Bình Luận Khi Mở Bản Trình Chiếu

Sử dụng Presentation.getViewProperties để truy cập cài đặt chế độ xem trên toàn bộ bản trình chiếu. Sử dụng ViewProperties.getShowComments và ViewProperties.setShowComments để đọc hoặc thay đổi tùy chọn lưu trữ về việc có hiển thị bình luận khi bản trình chiếu mở trong PowerPoint hoặc trình soạn thảo tương thích khác.

Cài đặt này chỉ kiểm soát tùy chọn chế độ xem được lưu. Nó không thêm, xoá, chỉnh sửa hay giải quyết bình luận. Ẩn bình luận vẫn giữ nguyên nội dung, tác giả, vị trí, trả lời và trạng thái của chúng. Xem Presentation Comments để biết các thao tác thay đổi bình luận.

Ví dụ sau yêu cầu một tệp comments.pptx hiện có có chứa bình luận. Nó in ra cài đặt hiển thị hiện tại, yêu cầu ẩn bình luận và lưu một tệp PPTX mới mà không xoá bất kỳ bình luận nào. Nó cũng sử dụng ViewProperties.setLastView với ViewType.SlideView để cấu hình chế độ chỉnh sửa ban đầu cùng với khả năng hiển thị bình luận.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

var presentation = new aspose.slides.Presentation("comments.pptx");
try {
    var showComments = presentation.getViewProperties().getShowComments();
    console.log("Current comment visibility: " + showComments);

    var hideComments = java.newByte(aspose.slides.NullableBool.False);
    presentation.getViewProperties().setShowComments(hideComments);
    presentation.getViewProperties().setLastView(aspose.slides.ViewType.SlideView);
    presentation.save("comments-hidden.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Cài đặt này không quyết định việc bình luận có được bao gồm trong các xuất PDF, HTML, hình ảnh, ghi chú hay handout hay không. Hãy cấu hình các tùy chọn xuất riêng biệt cho từng định dạng.

FAQ

Tại sao lưới không hiển thị sau khi tôi mở lại bản trình chiếu?

Tệp lưu khoảng cách lưới, nhưng trình soạn thảo kiểm soát việc lưới có được hiển thị hay không. Kiểm tra cài đặt hiển thị lưới của trình soạn thảo.

Việc xoá các hướng dẫn vẽ có thay đổi khoảng cách lưới không?

Không. Các hướng dẫn vẽ và khoảng cách lưới là các cài đặt độc lập. Xoá các hướng dẫn không thay đổi khoảng cách lưới đã lưu.

Tôi có thể đặt các cài đặt chế độ xem khác nhau cho các phần khác nhau của bản trình chiếu không?

View settings được định nghĩa ở mức bản trình chiếu (Normal View/Slide View), không theo phần, vì vậy một bộ tham số duy nhất áp dụng cho toàn bộ tài liệu khi mở.

Tôi có thể định trước các trạng thái chế độ xem cho các người dùng khác nhau không?

Không. Các cài đặt được lưu trong tệp và được chia sẻ. Các ứng dụng xem có thể tôn trọng tùy chọn của người dùng, nhưng tệp chỉ chứa một bộ thuộc tính chế độ xem.

Tôi có thể tạo mẫu với các View Properties được định trước để các bản trình chiếu mới mở cùng cách không?

Có. Vì view properties được lưu ở mức bản trình chiếu, bạn có thể nhúng chúng vào mẫu và tạo tài liệu mới từ mẫu với cùng cấu hình chế độ xem ban đầu.

Quản lý Thuộc tính Bài thuyết trình trong JavaScript Quản lý nhận xét bản trình bày trong Node.js