사용자가 텍스트, 숫자 및 기타 데이터를 입력할 수 있는 상자입니다.
Description
사용자는 텍스트 입력 컨트롤에 입력하여 데이터를 지정할 수 있습니다. 앱 구성 방식에 따라, 해당 데이터는 임시 값을 계산하는 데 사용하는 데이터 원본에 추가되거나 다른 방식으로 통합될 수 있습니다.
키 속성
기본값 - 사용자가 변경하기 전에 컨트롤의 초기 값입니다.
텍스트 – 컨트롤에 표시되거나 사용자가 컨트롤에 입력하는 텍스트입니다.
추가 속성
AccessibleLabel – 화면 읽기 프로그램에 대한 레이블입니다.
맞춤 – 컨트롤의 가로 가운데를 기준으로 텍스트의 위치입니다.
BorderColor – 컨트롤 테두리의 색입니다.
BorderStyle – 컨트롤의 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.
BorderThickness – 컨트롤 테두리의 두께입니다.
지우기 – 텍스트 입력 컨트롤에 사용자가 탭하거나 클릭하여 해당 컨트롤의 내용을 지울 수 있는 "X"가 표시되는지 여부입니다. SingleLine 모드에서만 작동합니다.
색 – 컨트롤의 텍스트 색입니다.
DelayOutput – true로 설정하면 사용자 입력이 반 초 지연 후에 등록됩니다. 사용자가 입력 텍스트를 완료할 때까지 비용이 많이 드는 작업을 지연하는 데 유용합니다(예: 다른 수식에서 입력을 사용하는 경우 필터링).
DisplayMode – 컨트롤에서 사용자 입력(편집)을 허용하는지 여부, 데이터만 표시(보기) 또는 사용 안 함(사용 안 함)입니다.
DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.
DisabledColor – DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.
DisabledFill – DisplayMode 속성이 Disabled 로 설정된 경우 컨트롤의 배경색입니다.
EnableSpellCheck – 텍스트 입력 컨트롤에서 브라우저 맞춤법 검사 함수를 사용해야 하는지 여부입니다. Windows용 Power Apps는 이 속성을 지원하지 않습니다.
Fill – 컨트롤의 배경색입니다.
FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.
FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.
글꼴 – 텍스트가 표시되는 글꼴 패밀리의 이름입니다.
FontWeight – 컨트롤에 있는 텍스트의 가중치: 굵게, 세미볼드, 노멀 또는 라이터.
형식 – 사용자 입력이 숫자로만 제한되는지 아니면 텍스트일 수 있는지 여부입니다. 숫자로 설정하면 숫자와 특정 숫자 기호만 입력할 수 있습니다. 지원되는 기호 및 형식은 브라우저 언어에 따라 달라지며 개별 컨트롤에서 설정할 수 없습니다.
높이 – 컨트롤의 위쪽 가장자리와 아래쪽 가장자리 사이의 거리입니다.
HintText – 비어 있는 경우 입력 텍스트 컨트롤에 표시되는 연한 회색 텍스트입니다.
HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 유지할 때 컨트롤의 테두리 색입니다.
HoverColor – 사용자가 마우스 포인터를 유지할 때 컨트롤의 텍스트 색입니다.
HoverFill – 사용자가 마우스 포인터를 유지할 때 컨트롤의 배경색입니다.
기울임꼴 – 컨트롤의 텍스트가 기울임꼴인지 여부입니다.
LineHeight – 예를 들어 목록의 텍스트 줄 또는 항목 사이의 거리입니다.
MaxLength – 사용자가 텍스트 입력 컨트롤에 입력할 수 있는 문자 수입니다.
모드 – 컨트롤이 단일 줄, 여러 줄 또는 암호 모드에 있습니다.
OnChange – 사용자가 컨트롤의 값을 변경할 때 수행할 작업(예: 슬라이더 조정).
OnSelect – 사용자가 컨트롤을 탭하거나 클릭할 때 수행할 작업입니다.
PaddingBottom – 컨트롤의 텍스트와 해당 컨트롤의 아래쪽 가장자리 사이의 거리입니다.
PaddingLeft – 컨트롤의 텍스트와 해당 컨트롤의 왼쪽 가장자리 사이의 거리입니다.
PaddingRight – 컨트롤의 텍스트와 해당 컨트롤의 오른쪽 가장자리 사이의 거리입니다.
PaddingTop – 컨트롤의 텍스트와 해당 컨트롤의 위쪽 가장자리 사이의 거리입니다.
PressedBorderColor – 사용자가 해당 컨트롤을 탭하거나 클릭할 때 컨트롤의 테두리 색입니다.
PressedColor – 사용자가 해당 컨트롤을 탭하거나 클릭할 때 컨트롤의 텍스트 색입니다.
PressedFill – 사용자가 해당 컨트롤을 탭하거나 클릭할 때 컨트롤의 배경색입니다.
RadiusBottomLeft – 컨트롤의 왼쪽 아래 모서리가 반올림되는 정도입니다.
RadiusBottomRight – 컨트롤의 오른쪽 아래 모서리가 반올림되는 정도입니다.
RadiusTopLeft – 컨트롤의 왼쪽 위 모서리가 반올림되는 정도입니다.
RadiusTopRight – 컨트롤의 오른쪽 위 모서리가 반올림되는 정도입니다.
다시 설정 – 컨트롤이 기본값으로 되돌아갈지 여부입니다.
크기 – 컨트롤에 표시되는 텍스트의 글꼴 크기입니다.
취소선 – 컨트롤에 나타나는 텍스트를 통해 선이 표시되는지 여부입니다.
TabIndex – 다른 컨트롤과 관련된 키보드 탐색 순서입니다.
도구 설명 – 사용자가 컨트롤을 마우스로 가리킬 때 표시되는 설명 텍스트입니다.
밑줄 – 컨트롤에 표시되는 텍스트 아래에 줄이 표시되는지 여부입니다.
VirtualKeyboardMode – 앱 사용자의 터치 스크린에 표시되는 가상 키보드, 텍스트 또는 숫자 유형입니다. Format 속성은 기본값을 결정합니다. 디바이스 지원은 다양합니다. iOS를 실행하는 디바이스에는 버전 12.2 이상이 있어야 합니다. 권장되는 Android 버전은 9.0이며, Android 디바이스에는 숫자 키보드의 기능이 다릅니다. Windows 10은 이 속성을 지원하지 않습니다.
표시 – 컨트롤이 표시되는지 숨겨지는지 여부입니다.
너비 – 컨트롤의 왼쪽 가장자리와 오른쪽 가장자리 사이의 거리입니다.
X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 왼쪽 가장자리 사이의 거리입니다.
Y – 컨트롤의 상단 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 상단 가장자리 사이의 거리입니다.
관련 함수
예시
데이터 수집
두 개의 텍스트 입력 컨트롤을 추가하고 inputFirst 및 inputLast의 이름을 지정합니다.
컨트롤을 추가, 이름 지정, 구성하는 방법을 모르십니까?
단추를 추가하고 Text 속성을Add로 설정하고 OnSelect 속성을 다음 수식으로 설정합니다.
Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})세로/세로 방향으로 텍스트 갤러리를 추가하고 Items 속성을 Names로 설정하고 Subtitle1의 Text 속성을 ThisItem.FirstName으로 설정합니다.
(선택 사항) 템플릿 갤러리에서 Body1이라는 아래쪽 레이블을 삭제하고 갤러리의 TemplateSize 속성을 80으로 설정합니다.
F5 키를 누르고 inputFirst 및 inputLast에 텍스트 문자열을 입력한 다음 추가 단추를 클릭하거나 탭합니다.
(선택 사항) 컬렉션에 이름을 더 추가한 다음 Esc 키를 눌러 기본 작업 영역으로 돌아갑니다.
암호 프롬프트
텍스트 입력 컨트롤을 추가하고, inputPassword로 이름을 지정하고, Mode 속성을 Password로 설정합니다.
레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.
If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access Denied")F5 키를 누른 다음 inputPassword에 P@ssw0rd 입력합니다.
암호 입력을 마치면 레이블에 액세스 거부 표시 가 중지되고 Access가 부여된 것으로 표시되기 시작합니다.
기본 작업 영역으로 돌아가려면 Esc 키를 누릅니다.
(선택 사항) 화살표와 같은 컨트롤을 추가하고, 다른 화면으로 이동하도록 구성하고, 사용자가 암호를 입력한 후에만 표시합니다.
(선택 사항) 단추를 추가하고, 로그인을 표시하도록 Text 속성을 구성하고, 타이머를 추가하고, 사용자가 잘못된 암호를 입력한 다음 로그인 단추를 클릭하거나 탭하는 경우 일정 시간 동안 입력 텍스트 컨트롤을 사용하지 않도록 설정합니다.
내게 필요한 옵션 지침
색 대비
화면 읽기 프로그램 지원
- AccessibleLabel 이 있어야 합니다.
키보드 지원
- TabIndex 는 키보드 사용자가 탐색할 수 있도록 0 이상이어야 합니다.
- 포커스 표시기를 명확하게 표시해야 합니다. 이 작업을 수행하려면 FocusedBorderColor 및 FocusedBorderThickness 를 사용합니다.