Power Apps의 갤러리 컨트롤

다른 컨트롤을 포함하고 데이터 집합을 보여주는 컨트롤입니다.

설명

갤러리 컨트롤에서는 데이터 원본의 여러 레코드를 표시할 수 있으며 각 레코드에는 다양한 유형의 데이터가 포함될 수 있습니다. 예를 들어, 갤러리 컨트롤을 사용하여 여러 연락처를 보여줄 수 있으며, 각 항목은 각 연락처에 대한 이름, 주소, 전화 번호를 포함한 연락처 정보를 보여줍니다.

각 데이터 필드는 갤러리 컨트롤 내의 개별 컨트롤에 나타납니다. 템플릿에서 해당 컨트롤을 구성할 수 있습니다. 템플릿은 갤러리 내에서 첫 번째 항목으로 나타납니다.

• 세로/가로 방향에서 갤러리 컨트롤의 왼쪽 가장자리.
• 그리고 세로/가로 방향에서 상단에 갤러리 컨트롤의 위.

템플릿에 적용한 변경 사항은 갤러리 컨트롤 전체에서 반영됩니다.

가변 높이 항목이 포함된 갤러리 및 이미지, 텍스트를 보여주는 사전 정의된 템플릿을 사용 가능합니다.

제한 사항

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

1. 모든 항목이 로드되기 전에 사용자가 유연한 높이 갤러리 컨트롤을 스크롤하면, 로딩이 완료된 후 현재 보고 있는 항목이 아래로 밀리고 보이지 않을 수 있습니다. 이 문제를 피하려면 유연한 높이 변수 대신 일반 갤러리 컨트롤을 사용합니다.
2. 다음 컨트롤은 갤러리 내에서 지원되지 않습니다.
   • 표시 양식
   • 편집 양식
   • PDF 뷰어
   • Power BI 타일
   • 서식 있는 텍스트 편집기
   • Scrollable screen (Fluid grid)
   • 웹 바코드 스캐너
3. 다른 갤러리 안에 하나의 갤러리만 추가할 수 있습니다.
4. 최소 TemplateSize는 1입니다. 이로 인해 템플릿 크기를 고려하지 않을 때 갤러리의 컨트롤이 예상 X 또는 Y 값에서 벗어날 수 있습니다.
5. 데이터에서 앱을 자동으로 생성하고 앱을 저장한 다음 다시 열면 갤러리 찾아보기에 데이터가 즉시 표시되지 않을 수 있습니다. 이 문제를 해결하려면 검색창에 문자를 하나 이상 입력한 다음 입력한 텍스트를 삭제합니다. 그러면 갤러리에 데이터가 예상대로 표시됩니다.
6. 갤러리에 동일한 데이터 원본 또는 컬렉션을 패치하는 OnChange 규칙이 있는 ComboBox, DatePicker, Slider 또는 Toggle 컨트롤이 포함된 경우 예기치 않은 성능 저하 또는 성능 저하가 발생할 수 있습니다. 갤러리의 데이터 원본를 패치하는 규칙은 패치와 다시 로드의 끝없는 순환을 생성할 수 있기 때문입니다. OnChange 이 문제를 방지하려면 이러한 컨트롤이 갤러리에 배치될 때 규칙을 사용하지 않는 것이 좋습니다. OnChange

키 속성

Default – 앱이 시작하면 갤러리에서 선택할 데이터 원본의 항목 또는 레코드입니다.

Items – 갤러리, 목록 또는 차트 등의 컨트롤에서 나타나는 데이터 원본입니다.

Selected – 선택한 항목입니다.

추가 속성

AccessibleLabel – 스크린 리더용 갤러리(항목 미포함) 레이블입니다. 항목 목록의 개념을 설명해야 합니다.

AllItems – 갤러리에 로드된 항목입니다. 이것은 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤하면 더 많은 항목이 로드될 수 있습니다. AllItems에는 각 갤러리 항목에 사용되는 컨트롤도 포함되어 있습니다.

AllItemsCount - 갤러리에 로드된 항목 수입니다. 이것은 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤하면 더 많은 항목이 로드될 수 있습니다.

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

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

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

DelayItemLoading - 화면이 처음 로드될 때까지 항목(행)의 로딩을 지연시킵니다.

DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.

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

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

ItemAccessibleLabel – 스크린 리더를위 한 각 갤러리 항목의 레이블입니다. 각 항목이 무엇인지 설명해야 합니다.

LoadingSpinner (없음, 컨트롤 또는 데이터 )- 없음인 경우 스피너가 표시되지 않습니다. 컨트롤 | 보이는 빈 행을 발생시키는 렌더링 패스가 나타날 때 데이터, 스피너가 보여집니다.

LoadingSpinnerColor - 로딩 스피너의 채우기 색상입니다. 기본값은 BorderColor로 설정됩니다.

NavigationStep – ShowNavigation 속성이 true로 설정되어 있고 사용자가 해당 갤러리 한쪽 끝에서 탐색 화살표를 선택할 경우 갤러리를 스크롤하는 정도입니다.

Selectable – 갤러리 항목을 선택할 수 있는지 여부입니다. true로 설정하면 화면 판독기는 갤러리를 선택 가능한 목록으로 식별합니다. 그러면 항목을 선택할 수 있습니다. false로 설정하면 화면 판독기는 갤러리를 일반 목록으로 식별하며 항목을 선택해도 선택되지 않습니다.

ShowNavigation – 사용자가 화살표를 선택하여 갤러리에서 항목을 스크롤할 수 있도록 갤러리의 각 끝에 화살표를 나타낼지 여부를 선택합니다.

ShowScrollbar – 사용자가 갤러리를 마우스로 가리킬 때 스크롤바를 나타낼지 여부를 선택합니다.

TemplateFill – 갤러리의 배경색입니다.

TemplatePadding – 갤러리에서 항목 사이의 거리입니다.

TemplateSize – 세로/세로 방향에서 갤러리의 템플릿 높이입니다. 또는 가로/landscape 방향에서 갤러리의 템플릿 너비입니다. 최소 크기는 1입니다.

Transition – 사용자가 갤러리의 항목을 가리킬 때 나타나는 시각 효과입니다(팝, 푸시 또는 없음).

Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.

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

WrapCount – 가로 또는 세로 레이아웃에 따라 각 행 또는 열당 표시되는 항목 수입니다.

X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너 또는 화면의 왼쪽 가장자리 사이의 거리입니다.

Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너 또는 화면의 위쪽 가장자리 사이의 거리입니다.

관련된 함수

Filter( DataSource, Formula )

Reset( Control ) - 갤러리를 초기 상태로 다시 설정합니다. 초기 상태는 첫 번째 항목으로 스크롤하고 첫 번째 항목을 선택하거나 존재하는 경우 기본값을 포함합니다.

참고

Reset 컨트롤은 갤러리의 모든 자식을 재귀적으로 초기화하지 않습니다.

예제

데이터 표시 및 필터링

• 텍스트 표시
• 이미지 표시
• 목록 옵션을 선택하여 데이터 필터링
• 슬라이더를 조정하여 데이터 필터링

사용자로부터 데이터 가져오기

• 텍스트 가져오기
• 이미지 가져오기
• 사진 가져오기
• 사운드 가져오기
• 드로잉 가져오기

접근성 지침

색 대비

갤러리 항목의 아무 곳이나 클릭하면 선택되어야 하는 경우 다음 사이에 적절한 색 대비가 있어야 합니다.

• BorderColor 및 갤러리 외부 색(테두리가 있는 경우).
• Fill 및 갤러리 외부 색(테두리가 없는 경우).

스크린 리더 지원

• AccessibleLabel이 있어야 합니다.

  참고

  갤러리의 항목이 변경되면 화면 읽기 프로그램이 이를 알립니다. AccessibleLabel도 언급됩니다. 이 언급은 알림에 대한 컨텍스트를 제공하고 동일한 화면에 여러 개의 갤러리가 있는 경우 더욱 중요합니다.

• 갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel을 사용해 갤러리 항목의 내용을 표시합니다.

• 사용자가 갤러리 항목을 선택하기 원한다면 Selectable의 값을 true로 설정합니다. 그렇지 않으면 해당 값을 false로 설정합니다.

• 갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel을 사용해 갤러리 항목의 콘텐츠 요약을 제공합니다.

• Selectable은 사용자가 갤러리 항목을 선택해야 하는지 여부에 따라 적절하게 설정해야 합니다.

키보드 지원

• ShowScrollbar를 true로 설정하는 것이 좋습니다. 대부분의 터치 스크린 디바이스에서 스크롤 막대는 스크롤이 시작될 때까지 표시되지 않습니다.

• 갤러리 항목의 아무 곳이나 클릭하면 선택되어야 하는 경우에는 키보드 사용자가 갤러리 항목을 선택할 수 있는 방법도 있어야 합니다. 예를 들어 OnSelect 속성이 Select(Parent) 로 설정된 버튼를 추가합니다.

  참고

  갤러리 외부의 컨트롤은 갤러리 내의 키보드 탐색 순서에서 고려되지 않습니다. 갤러리 내부 컨트롤의 TabIndex는 범위가 지정됩니다. 자세한 내용은 접근성 속성을 참조하십시오.

참조

DelayItemLoading 및 Loading 회전자를 사용하여 갤러리의 성능 향상

참고

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

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