다음을 통해 공유


Power Apps의 토글 컨트롤

핸들을 움직여 사용자가 켜거나 끌 수 있는 컨트롤입니다.

설명

토글은 최근 GUI용으로 설계되었으나 확인란과 동일한 방식으로 작동합니다.

주요 속성

Default – 사용자가 변경하기 전에 컨트롤의 초기 값입니다.

Value – 입력 컨트롤의 값입니다.

추가 속성

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

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

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

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

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

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

FalseFill – 토글이 꺼진 경우 토글 채우기 색입니다.

FalseHoverFill – 토글이 꺼진 경우 가리킨 항목의 채우기 색입니다.

FalseText – 토글이 꺼진 경우 표시되는 텍스트입니다.

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

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

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

HandleFill – 토글 핸들의 채우기 색입니다.

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

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

OnChange – 사용자가 컨트롤의 값을 변경할 때(예: 슬라이더 조절) 수행할 작업입니다.

OnCheck – 확인란의 값이나 토글이 으로 변경되었을 때 수행할 작업입니다.

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

OnUncheck – 확인란의 값이나 토글이 거짓으로 변경되었을 때 수행할 작업입니다.

PressedBorderColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 테두리 색입니다.

RailFill – 값이 false일 때 토글 컨트롤의 직사각형 배경색이거나 슬라이더 컨트롤에서 핸들 오른쪽의 라인 색입니다.

RailHoverFill – 토글 컨트롤 또는 슬라이더에 마우스를 가져가는 경우, 토글 컨트롤의 값이 false일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 오른쪽의 선 색입니다.

Reset – 컨트롤을 기본값으로 되돌릴지 여부를 선택합니다.

ShowLabel – 토글 컨트롤 옆에 텍스트 레이블을 표시할지 여부입니다.

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

TextPosition – 레이블을 토클 컨트롤의 왼쪽에 둘지 또는 오른쪽에 둘지 여부입니다.

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

TrueFill – 토글 켜진 경우 토글 채우기 색입니다.

TrueHoverFill – 토글이 켜진 경우 가리킨 항목의 채우기 색입니다.

TrueText – 토글이 켜진 경우 표시되는 텍스트입니다.

ValueFill – 토글 컨트롤의 값이 true일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 왼쪽의 선 색입니다.

ValueHoverFill – 토글 컨트롤이나 슬라이더에 마우스 포인터를 두고 있으면 값이 true일 때 토글 컨트롤의 직사각형 배경색이거나 슬라이더 컨트롤에서 핸들 왼쪽의 라인 색입니다.

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

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

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

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

If( Condition, Result )

  1. 토글을 추가하고 이름을MemberDiscount로 지정합니다.

    컨트롤을 추가, 이름을 지정하고, 구성하는 방법을 모르시나요?

  2. 레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

    If 함수 또는 다른 함수에 대해 더 알고 싶으신가요?

  3. F5 키를 누르고 MemberDiscount의 값을 변경합니다.

    레이블에 MemberDiscount의 설정 여부에 따라 다른 가격이 표시됩니다.

  4. 기본 작업 영역으로 돌아가려면, Esc를 누릅니다.

접근성 지침

색 대비

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

  • HandleFillFalseFill
  • HandleFillFalseHoverFill
  • HandleFillTrueFill
  • HandleFillTrueHoverFill
  • FalseFill 및 컨트롤 외부 색
  • FalseHoverFill 및 컨트롤 외부 색
  • TrueFill 및 컨트롤 외부 색
  • TrueHoverFill 및 컨트롤 외부 색

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

스크린 리더 지원

  • AccessibleLabel 이 있어야 합니다.
  • FalseText가 있어야 합니다.
  • TrueText가 있어야 합니다.

저시력 사용자 지원

  • 사용자가 토글 값을 빠르게 확인할 수 있도록 ShowLabeltrue로 설정하는 것이 좋습니다.

키보드 지원

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

참고

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

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