Power Apps의 첨부 파일 컨트롤

  • 아티클

사용자가 장치에 파일을 다운로드하고 Microsoft Lists 또는 Microsoft Dataverse 테이블을 사용하여 만든 목록에서 파일을 업로드 및 삭제할 수 있도록 하는 컨트롤입니다.

설명

첨부 파일 컨트롤을 사용하면 목록 또는 Dataverse 테이블에서 파일을 열고 추가하고 삭제할 수 있습니다.

제한 사항

attachment 컨트롤에는 이러한 제한 사항이 있습니다.

  1. attachment 컨트롤은 목록과 Dataverse 테이블만 데이터 소스로 지원합니다. 예를 들어 ForAll 함수를 사용하여 이러한 데이터 원본을 테이블로 변환하는 표현식은 지원되지 않습니다.

  2. 업로드 및 삭제 기능은 양식 내부에서만 작동합니다. Attachment 컨트롤은 편집 모드와 양식 외부에서는 비활성화된 것처럼 보입니다. 파일 추가 및 삭제를 저장하려면 앱 사용자가 양식을 저장해야 합니다. 이 제한으로 인해 Attachment 컨트롤은 삽입 탭에서 사용할 수 없지만 SharePoint 또는 Dataverse 양식에서 첨부 파일 양식 필드를 사용하도록 설정하면 양식에서 나타납니다.

  3. 웹 브라우저의 Attachment 컨트롤을 통해 여러 파일을 선택할 수 있으며 끌어서 놓기 기능을 사용할 수 있습니다. 그러나 Power Apps Mobile에서 첨부 파일 컨트롤을 사용할 경우 파일을 한 번에 하나씩만 추가할 수 있습니다.

키 속성

Items – 목록 또는 Dataverse 테이블의 첨부 열입니다. 컬렉션 및 테이블은 지원되지 않습니다.

MaxAttachments – 컨트롤에 허용되는 파일의 최대 수입니다.

MaxAttachmentSize – 새로운 첨부 파일당 허용되는 최대 파일 크기(MB)입니다. 여기서 1MB는 1,000,000바이트(106B) 또는 1,000KB입니다.

OnAddFile – 사용자가 새 첨부 파일을 추가할 때 수행할 작업입니다.

OnRemoveFile – 사용자가 기존 첨부 파일을 삭제할 때 수행할 작업입니다.

OnUndoRemoveFile – 사용자가 삭제된 첨부 파일을 복원할 때 수행할 작업입니다.

추가 속성

AccessibleLabel – 화면 읽기 프로그램의 레이블입니다. 첨부 파일의 목적을 설명해야 합니다.

AddAttachmentText – 새 첨부 파일을 추가하는 데 사용되는 링크의 레이블 텍스트입니다.

BorderColor – 컨트롤의 테두리 색입니다.

BorderStyle – 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.

BorderThickness – 컨트롤의 테두리 굵기입니다.

Color – 컨트롤의 텍스트 색입니다.

DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.

DisabledColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.

DisabledFill – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 배경색입니다.

DisplayMode – 컨트롤이 파일 추가 및 삭제(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.

[DropTargetBackgroundColor] – 컨트롤의 놓기 대상 배경색.

[DropTargetBorderColor] – 컨트롤의 놓기 대상 테두리색.

[DropTargetBorderStyle] – 실선, 파선, 점선 또는 없음 중 컨트롤의 테두리.

[DropTargetBorderThickness] – 컨트롤의 놓기 대상 테두리 두께.

[DropTargetTextColor] – 컨트롤의 놓기 대상 텍스트색.

Fill – 컨트롤의 배경색입니다.

FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.

FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.

Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.

Font – 텍스트가 표시되는 글꼴의 제품군 이름입니다.

FontWeight - 컨트롤의 텍스트 굵기입니다. Bold, Semibold, Normal 또는 Lighter입니다.

HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 테두리 색입니다.

HoverColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 텍스트 색입니다.

HoverFill – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 배경색입니다.

Italic - 컨트롤의 텍스트를 기울임꼴로 설정할지 여부를 선택합니다.

MaxAttachmentsText – 컨트롤이 허용되는 파일의 최대 수를 포함하는 경우 “첨부 파일” 링크를 대체하는 텍스트입니다.

NoAttachmentsText – 첨부된 파일이 없는 경우 사용자에게 표시되는 설명 텍스트입니다.

Padding – 가져오기 또는 내보내기 단추의 텍스트와 단추의 가장자리 사이의 간격입니다.

PressedBorderColor – 사용자가 컨트롤을 선택하는 경우 컨트롤의 테두리 색입니다.

PressedColor – 사용자가 컨트롤을 선택하는 경우 텍스트의 색입니다.

PressedFill – 사용자가 컨트롤을 선택하는 경우 컨트롤의 배경색입니다.

Reset – 첨부 파일 컨트롤에 대한 모든 변경 사항을 이전에 저장한 상태로 되돌립니다.

Size – 컨트롤에 표시되는 텍스트의 글꼴 크기입니다.

Strikethrough - 컨트롤에 표시되는 텍스트 중앙에 선을 표시할지 여부를 선택합니다.

TabIndex – 다른 컨트롤에 관련된 키보드 탐색 순서입니다.

Tooltip – 사용자가 컨트롤을 마우스로 가리킬 때 나타나는 설명 텍스트입니다.

Underline – 컨트롤에 표시되는 텍스트 아래에 선을 표시할지 여부를 선택합니다.

Visible – 컨트롤을 표시할지 또는 숨길지 여부입니다.

Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.

X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 왼쪽 가장자리 사이의 거리입니다.

Y – 컨트롤의 상단 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 상단 가장자리 사이의 거리입니다.

예

  1. 앱에 양식을 추가하고 목록을 데이터 원본으로 설정합니다.

  2. 왼쪽의 트리 뷰에서 표시 양식 컨트롤을 선택합니다. Edit form을 사용해도 됩니다.

  3. 오른쪽 옵션 패널에 있는 속성 탭에서 Data Source를 선택하고 연결한 목록을 선택합니다.

  4. 필드 섹션의 필드 편집을 선택하고 필드 추가를 선택합니다.

  5. 첨부 파일을 선택하고 추가를 선택합니다.

    목록과 연결된 첨부 파일 필드가 양식에 표시됩니다.

컨트롤을 추가하고 구성하는 방법 배우기

접근성 지침

색 대비

다음 사이에 적절한 색 대비가 있어야 합니다.

  • ItemColor 및 ItemFill
  • ItemHoverColor 및 ItemHoverFill
  • ItemPressedColor 및 ItemPressedFill
  • AddedItemColor 및 AddedItemFill
  • RemovedItemColor 및 RemovedItemFill
  • ItemErrorColor 및 ItemErrorFill
  • AddAttachmentColor 및 Fill
  • MaxAttachmentsColor 및 Fill
  • NoAttachmentsColor 및 Fill

이 요구 사항은 표준 색 대비 요구 사항에 추가됩니다.

스크린 리더 지원

다음 속성이 있어야 합니다.

키보드 지원

  • 키보드 사용자가 탐색할 수 있도록 TabIndex 가 0 이상이어야 합니다.
  • 포커스 표시기가 명확하게 표시되어야 합니다. FocusedBorderColor 및 FocusedBorderThickness 를 사용하여 이 선명도를 달성합니다.

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).