Power Apps의 텍스트 입력 컨트롤

사용자가 텍스트, 숫자 및 기타 데이터를 입력할 수 있는 상자입니다.

설명

사용자는 텍스트 입력 컨트롤에 입력하여 데이터를 지정할 수 있습니다. 앱 구성 방식에 따라, 해당 데이터는 임시 값을 계산하는 데 사용하는 데이터 원본에 추가되거나 다른 방식으로 통합될 수 있습니다.

주요 속성

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

Text – 컨트롤에 표시되는 텍스트 또는 사용자가 컨트롤에 입력하는 텍스트입니다.

추가 속성

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

Align - 컨트롤의 가로 가운데를 기준으로 한 텍스트의 위치입니다.

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

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

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

Clear – 텍스트 입력 컨트롤에서 사용자가 탭하거나 클릭하여 해당 컨트롤의 내용을 지울 수 있는 "X"를 표시할지 여부입니다.

Color – 컨트롤의 텍스트 색입니다.

DelayOutput – true로 설정된 경우 사용자 입력은 0.5초 지연 후에 등록됩니다. 사용자가 텍스트 입력을 완료할 때까지(예: 입력이 다른 수식에서 사용될 때 필터링하기 위해) 비용이 많이 드는 운영을 지연하는 데 유용합니다.

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

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

DisabledColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.

DisabledFill – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 배경색입니다.

EnableSpellCheck – 텍스트 입력 컨트롤이 브라우저 맞춤법 검사 기능을 사용해야 하는지 여부입니다. Windows용 Power Apps의 경우 이 속성을 지원하지 않습니다.

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

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

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

Font – 텍스트가 표시되는 글꼴의 제품군 이름입니다.

FontWeight - 컨트롤의 텍스트 굵기입니다. Bold, Semibold, Normal 또는 Lighter입니다.

Format – 사용자 입력이 숫자로만 제한되거나 어떤 텍스트라도 입력할 수 있는지 여부를 선택합니다. 숫자로 설정하면 숫자 및 특정 숫자 기호만 입력할 수 있습니다. 지원되는 기호 및 형식은 브라우저 언어에 따라 다르며 개별 컨트롤에서 설정할 수 없습니다.

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

HintText – 비어 있는 경우 입력 텍스트 컨트롤에 나타나는 연회색 텍스트입니다.

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

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

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

Italic - 컨트롤의 텍스트를 기울임꼴로 설정할지 여부를 선택합니다.

LineHeight - 예를 들어 텍스트 선 또는 목록의 항목 사이의 거리입니다.

MaxLength – 사용자가 텍스트 입력 컨트롤에 입력할 수 있는 문자 수입니다.

Mode – 컨트롤은 SingleLine, MultiLine 또는 Password 모드입니다.

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

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

PaddingBottom – 컨트롤의 텍스트와 해당 컨트롤의 하단 가장자리 사이의 거리입니다.

PaddingLeft – 컨트롤의 텍스트와 해당 컨트롤의 왼쪽 가장자리 사이의 거리입니다.

PaddingRight – 컨트롤의 텍스트와 해당 컨트롤의 오른쪽 가장자리 사이의 거리입니다.

PaddingTop – 컨트롤의 텍스트와 해당 컨트롤의 상단 가장자리 사이의 거리입니다.

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

PressedColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 텍스트 색입니다.

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

RadiusBottomLeft – 컨트롤 왼쪽 아래 모서리의 둥근 정도입니다.

RadiusBottomRight – 컨트롤 오른쪽 아래 모서리의 둥근 정도입니다.

RadiusTopLeft – 컨트롤 왼쪽 위 모서리의 둥근 정도입니다.

RadiusTopRight – 컨트롤 오른쪽 위 모서리의 둥근 정도입니다.

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

Size – 컨트롤에 표시되는 텍스트의 글꼴 크기입니다.

Strikethrough - 컨트롤에 표시되는 텍스트 중앙에 선을 표시할지 여부를 선택합니다.

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

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

Underline – 컨트롤에 표시되는 텍스트 아래에 선을 표시할지 여부를 선택합니다.

VirtualKeyboardMode – 앱 사용자의 터치 스크린에 나타나는 가상 키보드, 텍스트 또는 숫자의 유형입니다. Format 속성은 기본값을 결정합니다. 장치 지원은 다양합니다. iOS를 실행하는 디바이스는 버전 12.2 이상이어야 합니다. Android의 권장 버전은 9.0이며 Android 장치의 숫자 키보드의 기능은 다양합니다. Windows 10의 경우 이 속성을 지원하지 않습니다.

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

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

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

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

DateTimeValue( String )

예제

데이터 수집

  1. 두 개의 텍스트 입력 컨트롤을 추가하고 inputFirstinputLast로 이름을 지정합니다.

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

  2. 단추를 추가하고 Text 속성을 Add로 설정하고 OnSelect 속성을 다음 수식으로 설정합니다.
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

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

  3. 세로 방향으로 텍스트 갤러리를 추가하고 Items 속성을 Names로 설정하고 Subtitle1Text 속성을 ThisItem.FirstName으로 설정합니다.

  4. (선택 사항) 템플릿 갤러리에서 맨 아래 레이블(Body1)을 삭제하고 갤러리의 TemplateSize 속성을 80으로 설정합니다.

  5. F5 키를 누르고 텍스트의 문자열을 inputFirstinputLast에 입력한 다음, Add 단추를 클릭하거나 탭합니다.

  6. (선택 사항) 컬렉션에 이름을 더 추가한 다음, Esc 키를 눌러 기본 작업 영역으로 돌아갑니다.

암호를 묻는 메시지

  1. 텍스트 입력 컨트롤을 추가하고 이름을 inputPassword로 지정한 다음, Mode 속성을 Password로 설정합니다.

  2. 레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

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

  3. F5를 누른 다음 inputPasswordP@ssw0rd를 입력합니다.

    암호 입력을 마치면 Access denied를 표시하는 레이블이 중지하고 Access granted를 표시하기 시작합니다.

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

  5. (선택 사항) 화살표와 같은 컨트롤을 추가하고, 다른 화면으로 이동하도록 구성하며 사용자가 암호를 입력한 후에만 표시합니다.

  6. (선택 사항) 단추를 추가하고 Sign in을 표시하도록 Text 속성을 구성하며 사용자가 잘못된 암호를 입력한 다음 Sign in 단추를 클릭하거나 탭할 경우 일정 시간 동안 입력 텍스트 컨트롤을 비활성화합니다.

접근성 지침

색 대비

스크린 리더 지원

키보드 지원

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

참고

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

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