TextField QML Type

한 줄 텍스트 입력 필드입니다. 더 보기...

Import Statement:	`import QtQuick.Controls`
Inherits:	TextInput

상속된 멤버를 포함한 모든 멤버 목록

속성

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, 텍스트 필드 사용자 지정하기 및 입력 컨트롤을참조하세요 .

속성 문서

background : Item

이 속성은 배경 항목을 보유합니다.

참고: 배경 항목에 명시적인 크기가 지정되지 않은 경우 자동으로 컨트롤의 크기를 따릅니다. 대부분의 경우 배경 항목의 너비나 높이를 지정할 필요가 없습니다.

참고: 대부분의 컨트롤은 배경 항목의 암시적 크기를 사용하여 컨트롤 자체의 암시적 크기를 계산합니다. 배경 항목을 사용자 지정 항목으로 대체하는 경우 자체 암시적 크기가 있는 Image 같은 항목이 아니라면 적절한 암시적 크기를 제공하는 것도 고려해야 합니다.

텍스트 필드 사용자 지정하기를참조하세요 .

bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 배경의 하단 인셋을 유지합니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

Control Layout 및 topInset 을참조하십시오 .

focusReason : enumeration

이 속성은 마지막 포커스 변경의 이유를 저장합니다.

참고: 이 속성은 항목에 active focus 이 있는지 여부가 아니라 항목이 포커스를 얻거나 잃은 이유를 나타냅니다.

Constant	설명
`Qt.MouseFocusReason`	마우스 동작이 발생했습니다.
`Qt.TabFocusReason`	Tab 키를 눌렀습니다.
`Qt.BacktabFocusReason`	백탭이 발생했습니다. 이를 위한 입력에는 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 입니다.

pressed 및 released 을참조하세요 .

[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 을참조하십시오 .

© 2025 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.