다른 컨트롤을 포함하고 데이터 집합을 표시하는 컨트롤입니다.
Description
갤러리 컨트롤은 데이터 원본의 여러 레코드를 표시할 수 있으며 각 레코드에는 여러 형식의 데이터가 포함될 수 있습니다. 예를 들어 갤러리 컨트롤을 사용하여 각 연락처의 이름, 주소 및 전화 번호를 포함하는 연락처 정보를 표시하는 각 항목의 여러 연락처를 표시합니다.
각 데이터 필드는 갤러리 컨트롤 내의 별도 컨트롤에 나타납니다. 또한 템플릿에서 해당 컨트롤을 구성할 수 있습니다. 템플릿은 갤러리 내의 첫 번째 항목으로 나타납니다.
- 가로/가로 방향으로 갤러리 컨트롤의 왼쪽 가장자리에 있습니다.
- 그리고 세로/세로 방향으로 갤러리 컨트롤의 맨 위에 있습니다.
템플릿에서 변경한 내용은 갤러리 컨트롤 전체에 반영됩니다.
갤러리에 이미지와 텍스트를 표시하기 위한 미리 정의된 템플릿과 가변 높이 항목에 대한 갤러리를 사용할 수 있습니다.
제한점
갤러리 컨트롤에는 다음과 같은 제한 사항이 있습니다.
- 모든 항목이 로드되기 전에 사용자가 유연한 높이 갤러리 컨트롤을 스크롤하는 경우 데이터 로드가 완료되면 현재 보기에 있는 항목이 푸시다운되고 보기에서 벗어날 수 있습니다. 이 문제를 방지하려면 유연한 높이 변형 대신 표준 갤러리 컨트롤을 사용합니다.
- 갤러리 내에서 지원되지 않는 컨트롤은 다음과 같습니다.
- 다른 갤러리 내에 이미 있는 경우 다른 갤러리 내에 갤러리를 추가할 수 없습니다. 중첩의 최대 수준은 2입니다.
- 최소 TemplateSize 는 하나입니다. 이렇게 하면 템플릿 크기를 고려하지 않을 때 갤러리 의 컨트롤이 예상 X 또는 Y 값에서 드리프트될 수 있습니다.
- 데이터에서 앱을 자동으로 생성하고 앱을 저장한 다음 다시 열면 찾아보기 갤러리에 데이터가 즉시 표시되지 않을 수 있습니다. 이 문제를 해결하려면 검색 상자에 문자를 하나 이상 입력한 다음 입력한 텍스트를 삭제합니다. 그러면 갤러리에 데이터가 예상대로 표시됩니다.
- 갤러리에 갤러리와 동일한 데이터 원본 또는 컬렉션을 패치하는 규칙이 포함된
OnChangeComboBox, DatePicker, Slider 또는 Toggle 컨트롤이 포함되어 있으면 예기치 않거나 성능이 저하될 수 있습니다. 갤러리의 데이터 원본을OnChange패치하는 규칙이 패치 및 다시 로드의 끝없는 주기를 만들 수 있기 때문입니다. 이 문제를 방지하려면 이러한 컨트롤이 갤러리 내에 배치되는 경우 규칙을 사용하지OnChange않는 것이 좋습니다.
키 속성
기본값 - 앱이 시작될 때 갤러리에서 선택할 데이터 원본의 항목 또는 레코드입니다.
항목 – 갤러리, 목록 또는 차트와 같은 컨트롤에 표시되는 데이터의 원본입니다.
선택됨 – 선택한 항목입니다.
추가 속성
AccessibleLabel – 화면 읽기 프로그램에 대한 갤러리의 레이블(포함된 항목이 아님)입니다. 항목 목록을 설명해야 합니다.
AllItems – 갤러리에 로드되는 항목입니다. 이는 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤할 때 더 많은 항목이 로드될 수 있습니다. AllItems에는 각 갤러리 항목에 사용되는 컨트롤도 포함되어 있습니다.
AllItemsCount - 갤러리에 로드된 항목의 수입니다. 이는 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤할 때 더 많은 항목이 로드될 수 있습니다.
BorderColor – 컨트롤 테두리의 색입니다.
BorderStyle – 컨트롤의 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.
BorderThickness – 컨트롤 테두리의 두께입니다.
DelayItemLoading - 화면이 처음 로드될 때까지 항목(행) 로드를 지연합니다.
DisplayMode – 컨트롤에서 사용자 입력(편집)을 허용하는지 여부, 데이터만 표시(보기) 또는 사용 안 함(사용 안 함)입니다.
채우기 – 컨트롤의 배경색입니다.
높이 – 컨트롤의 위쪽 가장자리와 아래쪽 가장자리 사이의 거리입니다.
ItemAccessibleLabel – 화면 읽기 프로그램에 대한 각 갤러리 항목의 레이블입니다. 각 항목이 무엇인지 설명해야 합니다.
LoadingSpinner (없음, 컨트롤 또는 데이터 )- 없음인 경우 스피너가 표시되지 않습니다. When Controls | 데이터, 회전자는 빈 행이 표시되는 렌더링 패스가 발생할 때 표시됩니다.
LoadingSpinnerColor - 로딩 스피너의 채우기 색상입니다. 기본값은 BorderColor로 설정됩니다.
NavigationStep – ShowNavigation 속성이 true 로 설정되고 사용자가 해당 갤러리의 양쪽 끝에서 탐색 화살표를 선택하면 갤러리가 스크롤되는 정도입니다.
선택 가능 – 갤러리 항목을 선택할 수 있는지 여부입니다. true로 설정하면 화면 읽기 프로그램은 갤러리를 선택 가능한 목록으로 식별합니다. 항목을 선택하여 선택합니다. false로 설정하면 화면 읽기 프로그램은 갤러리를 일반 목록으로 식별하고 항목을 선택하지 않습니다.
ShowNavigation – 사용자가 화살표를 선택하여 갤러리의 항목을 스크롤할 수 있도록 갤러리의 각 끝에 화살표가 표시되는지 여부입니다.
ShowScrollbar – 사용자가 갤러리를 마우스로 가리킬 때 스크롤 막대가 표시되는지 여부입니다.
TemplateFill – 갤러리의 배경색입니다.
TemplatePadding – 갤러리의 항목 간 거리입니다.
TemplateSize – 세로/세로 방향으로 갤러리에 대한 템플릿의 높이입니다. 또는 가로/가로 방향으로 갤러리에 대한 템플릿의 너비입니다. 최소 크기는 1입니다.
전환 – 사용자가 갤러리의 항목 위로 마우스를 가져가면 시각적 효과(팝, 푸시 또는 없음)입니다.
표시 – 컨트롤이 표시되는지 숨겨지는지 여부입니다.
너비 – 컨트롤의 왼쪽 가장자리와 오른쪽 가장자리 사이의 거리입니다.
WrapCount – 가로 또는 세로 레이아웃을 기준으로 행 또는 열당 표시되는 항목 수입니다.
X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너 또는 화면의 왼쪽 가장자리 사이의 거리입니다.
Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너 또는 화면의 위쪽 가장자리 사이의 거리입니다.
관련 함수
Reset( Control ) - 갤러리를 초기 상태로 다시 설정합니다. 초기 상태에는 첫 번째 항목으로 스크롤하고 첫 번째 항목을 선택하거나 있는 경우 기본값을 선택하는 것이 포함됩니다.
비고
다시 설정 컨트롤이 갤러리의 모든 자식을 재귀적으로 다시 설정하지는 않습니다.
예시
데이터 표시 및 필터링
사용자로부터 데이터 가져오기
내게 필요한 옵션 지침
색 대비
갤러리 항목의 아무 곳이나 클릭하는 것이 선택하려는 경우 다음 사이에 적절한 색 대비가 있어야 합니다.
- BorderColor 및 갤러리 외부의 색(테두리가 있는 경우)입니다.
- 갤러리 외부의 채우기 및 색(테두리가 없는 경우).
화면 읽기 프로그램 지원
AccessibleLabel 이 있어야 합니다.
비고
화면 읽기 프로그램은 갤러리의 항목이 변경되는 시기를 알려 줍니다. AccessibleLabel도 언급됩니다. 이는 공지 사항에 대한 컨텍스트를 제공하며 동일한 화면에 여러 갤러리가 있는 경우 더욱 중요합니다.
갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel 을 사용하여 갤러리 항목의 내용을 표시합니다.
사용자가 갤러리 항목을 선택하도록 하려면 Selectable 값을 true 로 설정합니다. 그렇지 않으면 해당 값을 false로 설정합니다.
갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel 을 사용하여 갤러리 항목의 내용에 대한 요약을 제공합니다.
사용자가 갤러리 항목을 선택해야 하는지 여부에 따라 선택 가능 항목을 적절하게 설정해야 합니다.
키보드 지원
ShowScrollbar를 true로 설정하는 것이 좋습니다. 대부분의 터치 스크린 장치에서는 스크롤이 시작될 때까지 스크롤 막대가 표시되지 않습니다.
갤러리 항목의 아무 곳이나 클릭하는 것이 선택하려는 경우 키보드 사용자가 갤러리 항목을 선택하는 방법도 있어야 합니다. 예를 들어 OnSelect 속성이 Select(Parent)로 설정된 Button을 추가합니다.
비고
갤러리 외부의 컨트롤은 갤러리 내의 키보드 탐색 순서에서 고려되지 않습니다. 갤러리 내의 TabIndex 컨트롤의 범위가 지정됩니다. 자세한 내용은 접근성 속성을 참조하세요.