Pivot 제어

탐색을 제공하는 데 사용되는 컨트롤입니다.

노트

GitHub 코드 구성 요소 리포지토리에서 전체 설명서 및 소스 코드를 확인할 수 있습니다.

Description

Pivot 컨트롤 및 관련 탭 패턴은 자주 액세스하는 고유한 콘텐츠 범주를 탐색하는 데 사용됩니다. Pivot을 사용하면 둘 이상의 콘텐츠 보기 사이를 탐색할 수 있으며 Pivot은 콘텐츠의 서로 다른 섹션을 명확하게 표현하기 위해 텍스트 헤더에 의존합니다.

이 코드 구성 요소는 캔버스 앱 및 사용자 지정 페이지에서 사용하기 위해 유창한 UI Pivot 컨트롤 주위에 래퍼를 제공합니다.

속성

키 속성

Property	Description
RenderType	렌더링할 컨트롤의 유형입니다.
SelectedKey	선택할 키입니다. 이것은 사용자가 컨트롤과 상호 작용할 때 OnChange 이벤트를 통해 업데이트됩니다.
Items	렌더링할 작업 항목

Items 속성

각 항목은 다음 스키마를 사용하여 구성 요소의 데이터를 시각화합니다.

입력	Description
ItemDisplayName	탐색 항목의 표시 이름
ItemKey	어떤 항목이 선택되었는지 표시하고 하위 항목을 추가할 때 사용하는 키입니다. 키는 고유해야 합니다.
ItemEnabled	옵션이 비활성화된 경우 false로 설정
ItemVisible	옵션이 표시되지 않으면 false로 설정
ItemChecked	옵션이 선택된 경우 true로 설정합니다(예: 명령 모음의 분할 버튼)
ItemIconName	사용할 유창한 UI 아이콘(유창한 UI 아이콘 참조)
ItemCount	피벗 항목 링크에 항목 수를 표시합니다.

예:

Table(
  {
      ItemKey: "tabFile",
      ItemDisplayName: "File"
  },
  {
      ItemKey: "tabHome",
      ItemDisplayName: "Home"
  },
  {
      ItemKey: "tabView",
      ItemDisplayName: "View"
  },
  {
      ItemKey: "tabAction",
      ItemDisplayName: "Action"
  }
)

스타일 속성

Property	Description
Theme	유창한 UI 테마 디자이너(windows.net)를 사용하여 생성된 JSON 문자열을 허용합니다. 이 항목을 비워 두면 Power Apps에서 정의한 기본 테마가 사용됩니다. 설정 방법은 테마 설정을 참고하세요.
RenderSize	pivot 컨트롤은 두 가지 크기(대형/보통)로 렌더링할 수 있습니다
AccessibilityLabel	화면 읽기 프로그램 아리아-레이블

이벤트 속성

Property	Description
InputEvent	컨트롤에 보낼 이벤트입니다. 예: SetFocus. 아래를 참조하십시오.

동작

SetFocus를 InputEvent로 지원합니다.

탭 동작 구성

앱에 있는 종속 구성 요소(예: 페이지를 나타내는 컨테이너)의 Visible 속성을 Pivot1.Selected.ItemKey 값과 연결하여 탭 페이지를 조정합니다.

Visible tabFile itemKey가 선택되면 표시되는 종속 컨트롤의 속성:

Pivot1.Selected.ItemKey = "tabFile"

제한 사항

이 코드 구성 요소는 캔버스 앱 및 사용자 정의 페이지에서만 사용할 수 있습니다.

GitHub 문서의 디자인 과제 섹션에서 더 많은 제한 사항을 참조하세요.