PowerApps의 PDF 뷰어 컨트롤(실험)PDF viewer control (experimental) in PowerApps

PDF 파일의 콘텐츠를 표시하는 실험적 컨트롤입니다.An experimental control that shows the content of a PDF file.

설명Description

이 형식의 컨트롤을 추가하고, Document 속성을 표시하려는 파일의 URL(큰따옴표로 묶은)로 설정하여 PDF 파일에 있는 텍스트, 그래픽 및 기타 콘텐츠를 표시합니다.Show text, graphics, and other content in a PDF file by adding this type of control and setting its Document property to the URL, enclosed in double quotation marks, of the file that you want to show.

제한 사항Limitations

PowerApps의 보안 아키텍처로 인해 PDF 뷰어는 HTTP가 아닌 HTTPS 링크만을 지원합니다.Note that due to the security architecture of PowerApps, PDF Viewer only supports HTTPS links and not HTTP.
PDF 문서가 제한적인 CORS 설정을 사용하는 서버에 존재하는 경우 앱 내에서 볼 수 없습니다.If the PDF document resides on a server with restrictive CORS settings, you may not be able to view it within your app. 이 문제를 해결하려면 PDF 문서를 호스팅하는 서버에서 powerapps.com에서 오는 CORS(교차 원본 요청)를 허용해야 합니다.To resolve this issue, the server that hosts PDF documents needs to permit cross origin requests (CORS) coming from powerapps.com.

PowerApps에서 문서를 열 수 없는 경우 외부 브라우저에서 문서를 여는 옵션은 최종 사용자에게 표시됩니다.In case the document cannot be opened in PowerApps, the option to open the document in an external browser is presented to the end user. 이 옵션은 모든 외부 문서에 대한 컨트롤 메뉴에서 사용할 수 있습니다.This option is also available in the control menu for all external documents.

주요 속성Key properties

Document – PDF 파일의 URL(큰따옴표로 묶은)입니다.Document – The URL, enclosed in double-quotation marks, of a PDF file.

추가 속성Additional properties

ActualZoom - 컨트롤의 실제 확대/축소이며, Zoom 속성으로 요청된 확대/축소와 다를 수 있습니다.ActualZoom – The actual zoom of the control, which may differ from the zoom requested with the Zoom property.

BorderColor - 컨트롤의 테두리 색입니다.BorderColor – The color of a control's border.

BorderStyle - 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness - 컨트롤의 테두리 굵기입니다.BorderThickness – The thickness of a control's border.

CurrentFindText – 사용 중인 현재 검색어입니다.CurrentFindText – The current search term that is in use.

CurrentPage – 실제로 표시되는 PDF 파일의 페이지 번호입니다.CurrentPage – The number of the page in a PDF file that is actually being shown.

DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

Fill - 컨트롤의 배경색입니다.Fill – The background color of a control.

FindNext – 문서에서 FindText의 다른 인스턴스를 찾습니다.FindNext – Finds the next instance of FindText in the document.

FindPrevious – 문서에서 FindText의 이전 인스턴스를 찾습니다.FindPrevious – Finds the previous instance of FindText in the document.

FindText – 문서에서 찾을 검색어입니다.FindText – The search term to look for in the document.

Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.Height – The distance between a control's top and bottom edges.

HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 테두리 색입니다.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

OnSelect – 사용자가 앱을 클릭하거나 탭할 때 앱이 응답하는 방법입니다.OnSelect – How the app responds when the user taps or clicks a control.

OnStateChange – 컨트롤의 상태가 변할 때 앱이 응답하는 방식입니다.OnStateChange – How an app responds when the state of the control changes.

PaddingBottom – 컨트롤의 텍스트와 해당 컨트롤의 아래쪽 가장자리 사이의 거리입니다.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – 컨트롤의 텍스트와 해당 컨트롤의 왼쪽 가장자리 사이의 거리입니다.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – 컨트롤의 텍스트와 해당 컨트롤의 오른쪽 가장자리 사이의 거리입니다.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – 컨트롤의 텍스트와 해당 컨트롤의 위쪽 가장자리 사이의 거리입니다.PaddingTop – The distance between text in a control and the top edge of that control.

Page – 표시하려고 하는 페이지 수입니다.Page – The number of the page that you want to show.

PageCount -문서의 페이지 수입니다.PageCount – The number of pages in a document.

PressedBorderColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 테두리 색입니다.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

ShowControls - 오디오 또는 비디오 플레이어에서 재생 단추, 볼륨 슬라이더 등을 표시하는지 및 펜 컨트롤에서 그리기, 삭제 및 지우기 아이콘 등을 표시하는지 여부입니다.ShowControls – Whether an audio or video player shows, for example, a play button and a volume slider, and a pen control shows, for example, icons for drawing, erasing, and clearing.

Tooltip – 사용자가 마우스로 컨트롤을 가리킬 때 표시되는 설명 텍스트입니다.Tooltip – Explanatory text that appears when the user hovers over a control.

Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.Visible – Whether a control appears or is hidden.

Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.Width – The distance between a control's left and right edges.

X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 왼쪽 가장자리 사이의 거리입니다.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – 컨트롤의 위쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 위쪽 가장자리 사이의 거리입니다.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Zoom – 카메라의 이미지 확대 비율 또는 PDF 뷰어의 파일 보기입니다.Zoom – The percentage by which an image from a camera is magnified or the view of a file in a PDF viewer.

Example

다음 예와 같이 PDF 뷰어 컨트롤을 추가하고 Document 속성을 PDF 파일의 URL(큰따옴표로 묶인)로 설정합니다.Add a PDF viewer control, and set its Document property to the URL, enclosed in double quotation marks, of a PDF file as in this example:

"https://blog.mozilla.org/security/files/2015/05/HTTPS-FAQ.pdf""https://blog.mozilla.org/security/files/2015/05/HTTPS-FAQ.pdf"

The control shows the PDF file.

Don't know how to [add and configure a control](../add-configure-controls.md)?

접근성 지침Accessibility guidelines

PDF 뷰어가 여전히 실험 단계에 있기 때문에 PDF 문서의 일부 접근성 기능이 지원되지 않습니다.Not all accessibility features of PDF documents are supported because the PDF viewer is still in the experimental stage. 따라서 사용자가 외부 응용 프로그램에서 문서를 열 수 있으려면 ShowControlstrue로 설정해야 합니다.Therefore, ShowControls should be set to true to allow users to open the document in an external application.

WCAG 2.0PDF/UA 표준을 사용하여 접근성 있는 PDF 문서를 만드는 방법을 알아봅니다.Learn how to create accessible PDF documents with the WCAG 2.0 and PDF/UA standards.

화면 판독기 지원Screen reader support

  • PDF 문서에 제목이 없는 경우 레이블 을 제목을 추가하는 것이 좋습니다.Consider adding a heading using a Label, if the PDF document does not have a title. 제목은 PDF 뷰어 바로 앞에 배치할 수 있습니다.The heading can be positioned immediately before the PDF viewer.