Chức năng PDF (thử nghiệm)

Áp dụng cho: Ứng dụng canvas Ứng dụng dựa trên mô hình

[Bài viết này là tài liệu trước khi phát hành và có thể thay đổi.]

Xuất nội dung từ màn hình hiện tại sang một đối tượng để sử dụng trong nhiều tình huống.

Quan trọng

Description

Chức năng PDF cho phép bạn chọn một màn hình hoặc các phần của màn hình để xuất thành đối tượng PDF (blob).

Các tùy chọn cấu hình khác nhau cho phép các kết quả khác nhau đối với tệp PDF được tạo ra.

Quan trọng

  • Quá trình tạo PDF diễn ra trên thiết bị nơi ứng dụng đang chạy. Các thiết bị khác nhau như máy tính để bàn và thiết bị di động sẽ có dung lượng khác nhau khi bạn tạo PDF.
  • Việc tạo tệp PDF có kích thước tệp quá lớn có thể khiến ứng dụng bị lỗi. Điều này phụ thuộc vào dung lượng của thiết bị mà bạn đang chạy ứng dụng. Lưu ý về kích thước và số lượng hình ảnh cũng như lượng dữ liệu bạn muốn đưa vào tệp PDF được tạo, đặc biệt dành cho các ứng dụng dành cho sử dụng trên thiết bị di động.

Lưu ý

  • Bạn chỉ có thể tạo tệp PDF từ nội dung hiện có trên màn hình mà bạn đã gọi chức năng PDF. Ví dụ: nếu bạn đã thêm chức năng PDF trên màn hình hai, thì chỉ nội dung trong màn hình hai mới có thể được đưa vào tệp PDF được tạo.

Cú pháp

PDF(Tên màn hình hoặc điều khiển [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Tên màn hình hoặc điều khiển – Bắt buộc. Màn hình hoặc điều khiển chứa nội dung sẽ sử dụng để tạo PDF. Các điều khiển được hỗ trợ: Thư viện dọc, Bộ chứa bố cục dọc, Bộ chứa bố cục ngang, Bộ chứa, Màn hình.

  • Kích thước – Tùy chọn. Kiểm soát kích thước của PDF được tạo. Giá trị mặc định phụ thuộc vào ngôn ngữ của người dùng ứng dụng; Thư cho Hoa Kỳ và Canada và A4 cho các địa phương khác.

  • DPI – Không bắt buộc. Kiểm soát tỷ lệ/độ phân giải của PDF được tạo. Phải là một giá trị lớn hơn 0. Nội dung vượt quá không gian cho phép theo lề đã chỉ định có thể dẫn đến DPI hiệu quả cao hơn. Giá trị mặc định là 96.

  • Lề – Không bắt buộc. Một chuỗi chỉ định kích thước của khoảng trống dành riêng giữa nội dung và mép ngoài của tệp PDF được tạo. Mỗi lề của tệp PDF được tạo (trên, phải, dưới, trái) có thể hỗ trợ một giá trị khác. Các đơn vị đo lường được hỗ trợ cho giá trị này bao gồm cm, mm, pt và px. Giá trị mặc định là 0,5 inch (12,7 mm) cho tất cả các lề.

  • Định hướng – Không bắt buộc. Kiểm soát xem tệp PDF được tạo có hướng dọc (dọc) hay ngang (ngang). Giá trị mặc định là dọc (chiều dọc).

  • ExpandContainers – Không bắt buộc. Boolean. Kiểm soát xem các vùng chứa nhất định có nội dung vượt quá kích thước được phân bổ có mở rộng để hiển thị tất cả nội dung trong tệp PDF được tạo hay không. Các điều khiển bị ảnh hưởng bao gồm màn hình, vùng chứa, vùng chứa dọc và ngang, thư viện có chiều cao cố định dọc (không lồng nhau), biểu mẫu và điều khiển canvas có thể cuộn. Giá trị mặc định là sai.

Ví dụ

Công thức Mô tả Kết quả
PDF(Screen1) Tạo một đối tượng PDF với cài đặt mặc định. Một đối tượng PDF được tạo từ nội dung hiển thị của Screen1.
PDF(Container1, {Size: A3}) Tạo một đối tượng PDF với khổ giấy được đặt thành A3. Một đối tượng PDF có kích thước A3 được tạo từ nội dung hiển thị của Container1.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Tạo một đối tượng PDF với độ phân giải (DPI) được đặt thành 72, lề được đặt thành 25 mm và hướng được đặt thành ngang (ngang). Một tệp PDF có DPI, lề và hướng đã chỉ định được tạo ở kích thước mặc định (phụ thuộc vào ngôn ngữ) từ nội dung hiển thị trên Màn hình1.
PDF(Screen1, {ExpandContainers: true}) Tạo một đối tượng PDF với các điều khiển áp dụng được mở rộng. Một tệp PDF được tạo trong đó bất kỳ vùng chứa/bộ sưu tập nào có nhiều nội dung hơn mức hiển thị đều được mở rộng để hiển thị tất cả nội dung trong tệp PDF được tạo.

Các hạn chế đã biết

  • Một số điều khiển hiện không được hỗ trợ. Chúng bao gồm các biểu đồ, Power BI ô, Bản đồ và một số cấu hình kiểm soát PCF của bên thứ ba.

  • Bộ sưu tập lồng nhau không được hỗ trợ.

  • Các loại chữ viết không phải tiếng Latinh và trọng lượng cũng như kiểu phông chữ như in đậm và in nghiêng có thể không xuất hiện trong tệp PDF được tạo đối với một số phông chữ.

  • Tạo các tệp PDF có thể điền không được hỗ trợ.