다음을 통해 공유


PDF 함수(실험적)

적용 대상: Canvas 앱 모델 기반 앱

[이 문서는 시험판 문서이며 변경될 수 있습니다.]

여러 시나리오에서 사용할 수 있도록 현재 화면의 내용을 개체로 내보냅니다.

중요

Description

PDF 함수를 사용하면 PDF 개체(blob)로 내보낼 화면 또는 화면의 일부를 선택할 수 있습니다.

다양한 구성 옵션은 생성된 PDF에 대해 다양한 결과를 가능하게 합니다.

중요

  • PDF 생성은 앱이 실행되는 장치에서 발생합니다. 데스크톱 컴퓨터 및 모바일 장치와 같은 장치마다 PDF를 생성할 때 용량이 다릅니다.
  • 파일 크기가 매우 큰 PDF를 생성하면 앱이 충돌할 수 있습니다. 이는 앱을 실행하는 기기의 용량에 따라 다릅니다. 특히 모바일 디바이스에서 사용하기 위한 앱에 대해 생성된 PDF에 포함하려는 이미지의 크기와 수, 그리고 데이터의 양을 알고 있어야 합니다.

노트

  • PDF 함수를 호출한 화면에 존재하는 콘텐츠에서만 PDF를 생성할 수 있습니다. 예를 들어, 화면 2에 PDF 함수를 추가한 경우 화면 2의 내용만 생성된 PDF에 포함될 수 있습니다.

구문

PDF(화면 또는 컨트롤 이름 [,{크기, DPI, 여백, 방향, ExpandContainers}])

  • 화면 또는 컨트롤 이름 – 필수. PDF를 생성하는 데 사용할 콘텐츠가 포함된 화면 또는 컨트롤입니다. 지원되는 컨트롤: Vertical Gallery, Vertical Layout Container, Horizontal Layout Container, Container, Screen.

  • 크기 – 선택 사항. 생성된 PDF의 크기를 제어합니다. 기본값은 앱 사용자의 로캘에 따라 다릅니다. 미국 및 캐나다의 경우 편지, 기타 로캘의 경우 A4입니다.

  • DPI – 선택 사항. 생성된 PDF의 배율/해상도를 제어합니다. 0보다 큰 값이어야 합니다. 지정된 여백이 허용하는 공간을 초과하는 콘텐츠는 더 높은 유효 DPI를 초래할 수 있습니다. 기본값은 96입니다.

  • 여백 – 선택 사항. 콘텐츠와 생성된 PDF의 바깥쪽 가장자리 사이에 예약된 공간의 크기를 지정하는 문자열입니다. 생성된 PDF의 각 여백(위, 오른쪽, 아래, 왼쪽)은 다른 값을 지원할 수 있습니다. 이 값에 대해 지원되는 측정 단위에는 in, cm, mm, pt 및 px가 있습니다. 기본값은 모든 여백에 대해 0.5인치(12.7mm)입니다.

  • 방향 – 선택 사항. 생성된 PDF의 방향이 세로(수직)인지 가로(수평)인지를 제어합니다. 기본값은 세로(수직)입니다.

  • ExpandContainers – 선택 사항. 부울입니다. 할당된 크기를 초과하는 콘텐츠가 있는 특정 컨테이너가 생성된 PDF의 모든 콘텐츠를 표시하도록 확장되는지 여부를 제어합니다. 영향을 받는 컨트롤에는 screens, containers, vertical and horizontal containers, vertical fixed-height galleries (중첩되지 않음), forms 및 scrollable canvas 컨트롤이 포함됩니다. 기본값은 false입니다.

공식 설명 결과
PDF(화면1) 기본 설정으로 PDF 개체를 생성합니다. 화면1의 보이는 콘텐츠에서 PDF 개체가 생성됩니다.
PDF(컨테이너1, {크기: A3}) 용지 크기가 A3으로 설정된 PDF 개체를 생성합니다. 컨테이너1의 보이는 내용에서 A3 크기의 PDF 개체가 생성됩니다.
PDF(화면1, {DPI: 72, 여백: "25mm", 방향: "가로"}) 해상도(DPI)가 72로, 여백이 25밀리미터로, 방향이 가로(수평)로 설정된 PDF 개체를 생성합니다. 지정된 DPI, 여백 및 방향이 있는 PDF는 화면1에 표시되는 내용에서 기본 크기(로캘에 따라 다름)로 생성됩니다.
PDF(화면1, {컨테이너 확장: true}) 해당 컨트롤이 확장된 PDF 개체를 생성합니다. 보이는 것보다 더 많은 콘텐츠가 있는 컨테이너/갤러리가 생성된 PDF의 모든 콘텐츠를 표시하도록 확장되는 곳에 PDF가 생성됩니다.

알려진 제한 사항

  • 특정 컨트롤은 현재 지원되지 않습니다. 여기에는 차트, Power BI 타일, 맵 및 일부 타사 구성 PCF 컨트롤이 포함됩니다.

  • 중첩 갤러리는 지원되지 않습니다.

  • 일부 글꼴의 경우 굵게 및 기울임꼴과 같은 비라틴어 스크립트 유형과 글꼴 두께 및 스타일이 생성된 PDF에 표시되지 않을 수 있습니다.

  • 채울 수 있는 PDF 생성은 지원되지 않습니다.