다음을 통해 공유

Power Apps의 콤보 박스 컨트롤

  • 아티클

사용자가 제공된 선택 항목 중에서 선택할 수 있습니다. 검색과 다중 선택을 지원합니다.

설명

콤보 박스 컨트롤 선택 항목을 검색할 수 있습니다. 검색은 SearchField 속성의 서버 쪽에서 수행되므로 성능은 큰 데이터 원본에 의해 영향을 받지 않습니다.

단일 또는 다중 선택 모드는 SelectMultiple 속성을 통해 구성됩니다.

선택할 항목을 검색할 때 각 항목에 대해 데이터 창의 레이아웃 설정을 수정하여 단일 데이터 값, 두 개의 값 또는 그림과 두 개의 값(사람)을 표시하도록 선택할 수 있습니다.

작은 화면에서 볼 때 항목 목록 플라이 아웃은 더 나은 유용성을 위해 전체 화면 컨트롤이 됩니다.

참고

번호를 사용하여 항목을 검색하려는 경우 숫자를 Text 함수로 문자로 변환합니다. 예를 들어, Text(12345).

제한 사항

콤보 상자 컨트롤에는 이러한 제한 사항이 있습니다.

  • 갤러리 안에서 콤보 상자 컨트롤을 사용하면 사용자가 갤러리를 스크롤할 때 선택 항목이 유지되지 않습니다. 스크롤하지 않는 갤러리 내에서 콤보 상자 컨트롤을 사용하는 경우에는 문제가 되지 않습니다. 현재 사용할 수 있는 해결 방법이 없습니다.

인물 선택기

Combo box를 상대 선택으로 사용하려면, 데이터 창의 레이아웃 설정에서 사람 템플릿을 선택하고, 아래 사람에게 표시할 관련 데이터 속성을 구성합니다.

주요 속성

Items – 선택 항목을 만들 수 있는 데이터의 원본입니다.

DefaultSelectedItems – 사용자가 컨트롤과 상호 작용하기 전에 처음 선택한 항목입니다.

참고

Default 속성이 사용되지 않습니다. DefaultSelectedItems를 사용하세요.

""SelectedItems – 사용자 상호 작용을 통해 선택된 항목의 목록입니다.

SelectMultiple – 사용자가 단일 항목 또는 여러 항목을 선택할 수 있는지 여부입니다.

IsSearchable – 사용자가 선택하기 전에 항목을 검색할 수 있는지 선택합니다.

참고

IsSearchable은 하나 이상의 텍스트 필드가 포함된 데이터 원본에서만 사용 설정할 수 있습니다. Items 식은 검색으로 위임하려면 쿼리에 대해 위임 가능해야 합니다. 즉, Items 식 내 If 문은 지원되지 않습니다.

SearchFields - 사용자가 텍스트를 입력할 때 검색되는 데이터 원본의 데이터 필드입니다.

참고

여러 필드에서 검색하려면 SearchFields 속성을 ["MyFirstColumn", "MySecondColumn"]으로 설정합니다. 텍스트 필드만 지원됩니다.

추가 속성

AccessibleLabel – 화면 읽기 프로그램의 레이블입니다.

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

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

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

DisplayFields – 검색에서 반환된 각 항목에 대해 표시되는 필드의 목록입니다. 속성 옵션 탭에서 데이터 창을 통해 구성하는 것이 가장 쉬운 방법입니다.

참고

주어진 템플릿에서 여러 표시 필드를 업데이트하려면 DisplayFields 속성을 ["MyFirstColumn", "MySecondColumn"]으로 설정합니다.

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

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

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

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

InputTextPlaceholder – 선택된 항목이 없을 경우 최종 사용자에게 표시되는 교육용 텍스트입니다.

OnChange – 사용자가 선택 항목을 변경할 때 수행할 작업입니다.

OnNavigate – 사용자가 항목을 선택할 때 수행할 작업입니다.

OnSelect – 사용자가 컨트롤을 탭하거나 선택할 때 수행할 작업입니다.

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

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

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

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

Y - 컨트롤의 위쪽 가장자리와 상위 컨테이너의 위쪽 가장자리 사이의 거리(상위 컨테이너가 없으면 화면).

참고

플라이아웃 테두리 속성은 Border 속성으로 제어됩니다.

예

기본 콤보 상자

이 예의 단계는 모든 테이블을 제공하는 데이터 원본에 적용되지만, 이 단계를 정확히 수행하려면 샘플 데이터가 있는 Microsoft Dataverse 데이터베이스가 있는 환경을 사용하세요.

  1. 삽입 > 입력 > Combo box를 선택하고 이름을 'Combobox1'로 지정합니다.

  2. 화면 오른쪽 속성 창에서 데이터 원본 선택 목록(Items 옆)을 선택한 다음 거래처 테이블과 같은 데이터 원본을 추가 또는 선택합니다.

  3. 같은 창에서 편집(필드 옆)을 선택합니다.

  4. 데이터 창에서 기본 텍스트 목록을 연 다음 콤보 박스 컨트롤에 표시될 기본 이름 열을 선택합니다.

  5. Alt 키를 누른 상태에서 아래쪽 화살표를 선택하여 콤보 박스 컨트롤을 엽니다.

    컨트롤에는 사용자가 지정한 데이터 원본에 지정한 기본 이름의 데이터가 표시됩니다.

(선택 사항) 기본적으로 첫 번째 레코드 표시

  1. DefaultSelectedItems 속성을 이 식으로 설정하고 DataSource를 데이터 원본의 이름으로 바꿉니다.

    First(DataSource)

(선택 사항) 선택한 거래처 이름 값을 레이블에 표시

  1. 삽입 > 텍스트 레이블을 선택한 다음 레이블을 선택합니다.

  2. Text 속성을 이 식으로 설정하고 Text를 다음 수식으로 바꿉니다.

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")

    참고

    If 문은 선택된 항목이 어떻게 존재하는지 확인하고, 항목이 비어 있는 경우 쉼표로 구분된 레이블 또는 '선택 항목 없음' 메시지를 표시합니다.

간단한 드롭다운 동작 시뮬레이션

IsSearchable을 거짓, SelectMultiple을 거짓으로 설정하면 드롭다운과 동일한 기능을 얻을 수 있습니다.

  1. 삽입 > 입력을 선택한 다음 Combo box를 선택합니다.

  2. 화면 오른쪽 속성 창에서 데이터 원본 선택 목록(Items 옆)을 선택한 다음 데이터 원본을 추가 또는 선택합니다.

  3. 같은 창에서 편집(필드 옆)을 선택합니다.

  4. 데이터 창에서 기본 텍스트 목록을 열고 콤보 박스 컨트롤에서 표시하려는 열을 선택합니다.

  5. IsSearchable 속성을 거짓으로 설정합니다.

  6. SelectMultiple 속성을 거짓으로 설정합니다.

  7. Alt 키를 누른 상태에서 아래쪽 화살표를 선택하여 콤보 박스 컨트롤을 엽니다.

    컨트롤은 지정한 데이터 원본에 지정한 열의 데이터를 표시합니다.

    참고

    '항목 찾기' 텍스트가 사라졌고 단일 항목만 선택할 수 있습니다.

접근성 지침

색 대비

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

  • ChevronFill 및 ChevronBackground
  • ChevronHoverFill 및 ChevronHoverBackground
  • SelectionColor 및 SelectionFill
  • SelectionFill 및 Fill
  • SelectionTagColor 및 SelectionTagFill

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

스크린 리더 지원

  • AccessibleLabel 이 있어야 합니다.

    참고

    터치 스크린에서 화면 읽기 프로그램 사용자는 콤보 박스의 콘텐츠를 순차적으로 탐색할 수 있습니다. 콤보 박스는 선택 시 해당 콘텐츠를 표시하거나 숨기는 단추 역할을 합니다.

키보드 지원

  • 키보드 사용자가 탐색할 수 있도록 TabIndex 가 0 이상이어야 합니다.

  • 포커스 표시기가 명확하게 표시되어야 합니다. FocusedBorderColor 및 FocusedBorderThickness 를 사용하여 이를 달성합니다.

    참고

    Tab 키는 콤보 박스로 이동하거나 멀어지도록 이동합니다. 화살표 키는 콤보 박스의 콘텐츠를 탐색합니다. Esc 키는 열려 있는 드롭다운을 닫습니다.

참고

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

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