PowerApps의 텍스트 입력 컨트롤Text input control in PowerApps

사용자가 텍스트, 숫자 및 기타 데이터를 입력할 수 있는 상자입니다.A box in which the user can type text, numbers, and other data.

설명Description

사용자는 텍스트 입력 컨트롤에 입력하여 데이터를 지정할 수 있습니다.The user can specify data by typing into a text-input control. 앱 구성 방식에 따라, 해당 데이터는 임시 값을 계산하는 데 사용하는 데이터 원본에 추가되거나 다른 방식으로 통합될 수 있습니다.Depending on how you configure the app, that data might be added to a data source, used to calculate a temporary value, or incorporated in some other way.

주요 속성Key properties

Default – 사용자가 컨트롤을 변경하기 전의 초기 값입니다.Default – The initial value of a control before it is changed by the user.

Text – 컨트롤에 표시되는 텍스트 또는 사용자가 컨트롤에 입력하는 텍스트입니다.Text – Text that appears on a control or that the user types into a control.

추가 속성Additional properties

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

Align - 컨트롤의 가로 가운데를 기준으로 한 텍스트의 위치입니다.Align – The location of text in relation to the horizontal center of its control.

BorderColor - 컨트롤의 테두리 색입니다.BorderColor – The color of a control's border.

BorderStyle - 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness - 컨트롤의 테두리 굵기입니다.BorderThickness – The thickness of a control's border.

Clear – 텍스트 입력 컨트롤에 사용자가 해당 컨트롤의 내용을 지우기 위해 탭하거나 클릭할 수 있는 “X”를 표시할지 여부를 선택합니다.Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color – 컨트롤의 텍스트 색입니다.Color – The color of text in a control.

DelayOutput – true로 설정된 경우 사용자 입력은 0.5초 지연 후에 등록됩니다.DelayOutput – When set to true, user input is registered after half a second delay. 사용자가 텍스트 입력을 완료할 때까지(예: 입력이 다른 수식에서사용될 때 필터링하기 위해) 비용이 많이 드는 운영을 지연하는 데 유용합니다Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 배경색입니다.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill - 컨트롤의 배경색입니다.Fill – The background color of a control.

FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.FocusedBorderThickness – The thickness of a control's border when the control is focused.

Font – 텍스트가 표시되는 글꼴의 제품군 이름입니다.Font – The name of the family of fonts in which text appears.

FontWeight - 컨트롤의 텍스트 굵기입니다. Bold, Semibold, Normal 또는 Lighter로 설정합니다.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Format – 사용자 입력이 숫자로만 제한되거나 어떤 텍스트라도 입력할 수 있는지 여부를 선택합니다.Format – Whether the user input is restricted to numbers only or can be any text.

Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.Height – The distance between a control's top and bottom edges.

HintText – 비어 있는 경우 입력 텍스트 컨트롤에 나타나는 연회색 텍스트입니다.HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 테두리 색입니다.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 텍스트 색입니다.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 배경색입니다.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic - 컨트롤의 텍스트를 기울임꼴로 설정할지 여부를 선택합니다.Italic – Whether the text in a control is italic.

LineHeight - 예를 들어 텍스트 선 또는 목록의 항목 사이의 거리입니다.LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength – 사용자가 텍스트 입력 컨트롤에 입력할 수 있는 문자 수입니다.MaxLength – The number of characters that the user can type into a text-input control.

Mode – 컨트롤은 SingleLine, MultiLine 또는 Password 모드입니다.Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange – 사용자가 컨트롤의 값을 변경할 때(예: 슬라이더 조절) 앱이 응답하는 방식입니다.OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – 사용자가 앱을 클릭하거나 탭할 때 앱이 응답하는 방법입니다.OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – 컨트롤의 텍스트와 해당 컨트롤의 아래쪽 가장자리 사이의 거리입니다.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – 컨트롤의 텍스트와 해당 컨트롤의 왼쪽 가장자리 사이의 거리입니다.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – 컨트롤의 텍스트와 해당 컨트롤의 오른쪽 가장자리 사이의 거리입니다.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – 컨트롤의 텍스트와 해당 컨트롤의 위쪽 가장자리 사이의 거리입니다.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 테두리 색입니다.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 텍스트 색입니다.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 배경색입니다.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – 컨트롤 왼쪽 아래 모서리의 둥근 정도입니다.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – 컨트롤 오른쪽 아래 모서리의 둥근 정도입니다.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – 컨트롤 왼쪽 위 모서리의 둥근 정도입니다.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – 컨트롤 오른쪽 위 모서리의 둥근 정도입니다.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Reset – 컨트롤이 기본값으로 되돌아가는지 여부입니다.Reset – Whether a control reverts to its default value.

Size -컨트롤에 표시되는 텍스트의 글꼴 크기입니다.Size – The font size of the text that appears on a control.

Strikethrough - 컨트롤에 표시되는 텍스트 중앙에 선을 표시할지 여부를 선택합니다.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – 다른 컨트롤에 관련된 키보드 탐색 순서입니다.TabIndex – Keyboard navigation order in relation to other controls.

Tooltip – 사용자가 마우스로 컨트롤을 가리킬 때 표시되는 설명 텍스트입니다.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – 컨트롤에 표시되는 텍스트 아래에 선을 표시할지 여부를 선택합니다.Underline – Whether a line appears under the text that appears on a control.

Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.Visible – Whether a control appears or is hidden.

Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.Width – The distance between a control's left and right edges.

X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 왼쪽 가장자리 사이의 거리입니다.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – 컨트롤의 위쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 위쪽 가장자리 사이의 거리입니다.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

DateTimeValue( String )DateTimeValue( String )

Examples

데이터 수집Collect data

  1. 두 개의 텍스트 입력 컨트롤을 추가하고 inputFirstinputLast로 이름을 지정합니다.Add two text-input controls, and name them inputFirst and inputLast.

    컨트롤을 추가, 이름을 지정하고, 구성하는 방법을 모르시나요?Don't know how to add, name, and configure a control?

  2. 단추 컨트롤을 추가하고 Text 속성을 Add로 설정하고 OnSelect 속성을 다음 수식으로 설정합니다.Add a button, set its Text property to Add, and set its OnSelect property to this formula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Collect 함수 또는 다른 함수에 대해 더 알고 싶으신가요?Want more information about the Collect function or other functions?

  3. 세로 방향으로 텍스트 갤러리를 추가하고 Items 속성을 Names로 설정하고 Subtitle1Text 속성을 ThisItem.FirstName으로 설정합니다.Add a text gallery in portrait/vertical orientation, set its Items property to Names, and set the Text property of Subtitle1 to ThisItem.FirstName.

  4. (선택 사항) 템플릿 갤러리에서 맨 아래 레이블(Body1)을 삭제하고 갤러리의 TemplateSize 속성을 80으로 설정합니다.(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.

  5. F5 키를 누르고 텍스트의 문자열을 inputFirstinputLast에 입력한 다음, Add 단추를 클릭하거나 탭합니다.Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.

  6. (선택 사항) 컬렉션에 이름을 더 추가한 다음, Esc 키를 눌러 기본 작업 영역으로 돌아갑니다.(optional) Add more names to the collection, and then press Esc to return to the default workspace.

암호를 묻는 메시지Prompt for a password

  1. 텍스트 입력 컨트롤을 추가하고 이름을 inputPassword로 지정한 다음, Mode 속성을 Password로 설정합니다.Add a text-input control, name it inputPassword, and set its Mode property to Password.

  2. 레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    If 함수 또는 다른 함수에 대해 더 알고 싶으신가요?Want more information about the If function or other functions?

  3. F5 키를 누르고 inputPassword에 **P@ssw0rd**를 입력합니다.Press F5, and then type **P@ssw0rd** in inputPassword.

    암호 입력을 마치면 Access denied를 표시하는 레이블이 중지하고 Access granted를 표시하기 시작합니다.When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. 기본 작업 영역으로 돌아가려면 Esc 키를 누릅니다.To return to the default workspace, press Esc.

  5. (선택 사항) 화살표와 같은 컨트롤을 추가하고, 다른 화면으로 이동하도록 구성하며 사용자가 암호를 입력한 후에만 표시합니다.(optional) Add a control such as an arrow, configure it to navigate to another screen, and show it only after the user types the password.

  6. (선택 사항) 단추를 추가하고 Sign in을 표시하도록 Text 속성을 구성하며 사용자가 잘못된 암호를 입력한 다음, Sign in 단추를 클릭하거나 탭할 경우 일정 시간 동안 입력 텍스트 컨트롤을 비활성화합니다.(optional) Add a button, configure its Text property to show Sign in, add a timer, and disable the input-text control for a certain amount of time if the user types the wrong password and then clicks or taps the Sign in button.

접근성 지침Accessibility guidelines

색 대비Color contrast

화면 판독기 지원Screen reader support

키보드 지원Keyboard support