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 – 컨트롤의 상단 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 상단 가장자리 사이의 거리입니다.
관련된 함수
예
토글을 추가하고 이름을MemberDiscount로 지정합니다.
컨트롤을 추가, 이름을 지정하고, 구성하는 방법을 모르시나요?
레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.
If(MemberDiscount.Value = true, "Price: $75", "Price: $100")F5 키를 누르고 MemberDiscount의 값을 변경합니다.
레이블에 MemberDiscount의 설정 여부에 따라 다른 가격이 표시됩니다.
기본 작업 영역으로 돌아가려면, Esc를 누릅니다.
접근성 지침
색 대비
다음 사이에 적절한 색 대비가 있어야 합니다.
- HandleFill 및 FalseFill
- HandleFill 및 FalseHoverFill
- HandleFill 및 TrueFill
- HandleFill 및 TrueHoverFill
- FalseFill 및 컨트롤 외부 색
- FalseHoverFill 및 컨트롤 외부 색
- TrueFill 및 컨트롤 외부 색
- TrueHoverFill 및 컨트롤 외부 색
이는 표준 색 대비 요구 사항에 추가됩니다.
스크린 리더 지원
- AccessibleLabel 이 있어야 합니다.
- FalseText가 있어야 합니다.
- TrueText가 있어야 합니다.
저시력 사용자 지원
- 사용자가 토글 값을 빠르게 확인할 수 있도록 ShowLabel을 true로 설정하는 것이 좋습니다.
키보드 지원
- 키보드 사용자가 탐색할 수 있도록 TabIndex 가 0 이상이어야 합니다.
- 포커스 표시기가 명확하게 표시되어야 합니다. FocusedBorderColor 및 FocusedBorderThickness 를 사용하여 이를 달성합니다.
참고
귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)
이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).