TextField QML Type
한 줄 텍스트 입력란. 더 보기...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
속성
- background : Item
- bottomInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - focusReason : enumeration
- hoverEnabled : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - hovered : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - implicitBackgroundHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitBackgroundWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - leftInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - placeholderText : string
- placeholderTextColor : color
(since QtQuick.Controls 2.5 (Qt 5.12)) - rightInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - topInset : real
(since QtQuick.Controls 2.5 (Qt 5.12))
신호
- pressAndHold(MouseEvent event)
- pressed(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8)) - released(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8))
상세 설명
TextField는 한 줄 텍스트 편집기입니다. TextField는 placeholder text 기능을 갖춘 TextInput 를 상속하며, 장식 요소를 추가합니다.
| 일반 상태의 텍스트 필드입니다. |
| 포커스가 활성화된 텍스트 필드입니다. |
| 비활성화된 텍스트 필드입니다. |
TextField {
placeholderText: qsTr("Enter name")
}TextArea, TextField 사용자 정의 및 입력 컨트롤도 참조하십시오 .
속성 설명서
background : Item
이 속성은 배경 항목을 포함합니다.
참고: 배경 항목에 명시적인 크기가 지정되지 않은경우 , 자동으로 컨트롤의 크기를 따릅니다. 대부분의 경우 배경 항목의 너비나 높이를 별도로 지정할 필요가 없습니다.
참고: 대부분의 컨트롤은 배경 항목의 암시적 크기를 사용하여 컨트롤 자체의 암시적 크기를 계산합니다. 배경 항목을 사용자 정의 항목으로 대체하는 경우, 해당 항목에 적절한 암시적 크기를 지정하는 것도 고려해야 합니다( Image 와 같이 자체 암시적 크기를 가진 항목은 예외).
'TextField 사용자 정의' 항목도 참조하십시오 .
bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 배경의 하단 여백을 지정합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
Control Layout 및 topInset도 참조하십시오 .
focusReason : enumeration
이 속성은 마지막 포커스 변경의 원인을 나타냅니다.
참고: 이 속성은 항목이 포커스( active focus)를 가지고 있는지 여부를 나타내는 것이 아니라, 해당 항목이 포커스를 얻거나 잃게 된 이유를 나타냅니다.
| 상수 | 설명 |
|---|---|
Qt.MouseFocusReason | 마우스 동작이 발생했습니다. |
Qt.TabFocusReason | Tab 키가 눌렸습니다. |
Qt.BacktabFocusReason | Backtab이 발생했습니다. 이에 대한 입력에는 Shift 또는 Control 키가 포함될 수 있습니다(예: Shift+Tab). |
Qt.ActiveWindowFocusReason | 창 시스템이 이 창을 활성 상태로 만들거나 비활성 상태로 만들었습니다. |
Qt.PopupFocusReason | 응용 프로그램이 키보드 포커스를 확보하거나 해제하는 팝업을 열거나 닫았습니다. |
Qt.ShortcutFocusReason | 사용자가 레이블의 버디 단축키를 입력했습니다. |
Qt.MenuBarFocusReason | 메뉴 바가 포커스를 받았습니다. |
Qt.OtherFocusReason | 다른 이유(일반적으로 애플리케이션에 따라 다름). 참고: 이 속성보다는 ` QtQuick.Controls::Control::focusReason `를사용하는 것이 좋습니다 . |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
이 속성은 텍스트 필드가 호버 이벤트를 허용할지 여부를 결정합니다. 기본값은 ` false`입니다.
이 속성은 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.
hovered도 참조하십시오 .
hovered : bool [read-only, since QtQuick.Controls 2.1 (Qt 5.8)]
이 속성은 텍스트 필드에 마우스가 호버 상태인지 여부를 나타냅니다.
이 속성은 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.
hoverEnabled도 참조하십시오 .
implicitBackgroundHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 암시적인 배경 높이를 저장합니다.
값은 ` background ? background.implicitHeight : 0`와 같습니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
implicitBackgroundWidth도 참조하십시오 .
implicitBackgroundWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 암시적 배경 너비를 지정합니다.
값은 ` background ? background.implicitWidth : 0`와 같습니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
implicitBackgroundHeight도 참조하십시오 .
leftInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 배경의 왼쪽 여백을 지정합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
Control Layout 및 rightInset도 참조하십시오 .
placeholderText : string
이 속성은 사용자가 텍스트를 입력하기 전에 ‘ TextField ’에 표시되는 힌트를 저장합니다.
placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 ` placeholderText`의 색상을 저장합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
placeholderText도 참조하십시오 .
rightInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 배경의 오른쪽 여백을 지정합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
Control Layout 및 leftInset도 참조하십시오 .
topInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 배경의 상단 여백을 지정합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
Control Layout 및 bottomInset도 참조하십시오 .
신호 문서
pressAndHold(MouseEvent event)
이 신호는 길게 누를 때 발생합니다(지연 시간은 플랫폼 플러그인에 따라 다릅니다). event 매개변수는 누른 위치의 x, y 좌표와 누른 버튼 정보를 포함하여 누름 동작에 대한 정보를 제공합니다.
참고: 이에 해당하는핸들러는 ` onPressAndHold`입니다.
[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)
이 신호는 사용자가 텍스트 필드를 눌렀을 때 발생합니다. ` event ` 매개변수는 눌린 위치의 x, y 좌표와 어떤 버튼이 눌렸는지 등, 누름 동작에 대한 정보를 제공합니다.
참고: 이에 대응하는핸들러는 onPressed 입니다.
이 신호는 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.
released 및 pressAndHold도 참조하십시오 .
[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)
이 신호는 사용자가 텍스트 필드에서 손가락을 떼면 발생합니다. ` event ` 매개변수는 터치 지점의 x, y 좌표와 누른 버튼 정보를 포함하여 손가락을 뗀 것에 대한 정보를 제공합니다.
참고: 해당핸들러는 ` onReleased`입니다.
이 신호는 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.
pressed 및 pressAndHold도 참조하십시오 .
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.


