Back to Qt.io
Contact Us Blog Download Qt

TextArea QML Type

여러 줄 텍스트 입력 영역. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

TextEdit

속성

첨부 속성

신호

  • 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))

자세한 설명

TextArea는 여러 줄 텍스트 편집기입니다. TextArea는 TextEdit 기능을 placeholder text 기능으로 확장하고 장식을 추가합니다.

TextArea {
    placeholderText: qsTr("Enter description")
}

TextArea는 자체적으로 스크롤할 수 없습니다. 특히 화면 크기가 제한된 플랫폼에서는 전체 애플리케이션 페이지를 스크롤 가능하게 만드는 것이 바람직할 때가 많습니다. 이러한 스크롤 가능한 페이지에서는 스크롤할 수 없는 텍스트 영역이 중첩된 스크롤 가능한 컨트롤보다 더 잘 작동할 수 있습니다. 그러나 이러한 시나리오에서는 TextArea의 배경 장식이 스크롤 가능한 나머지 콘텐츠와 함께 스크롤된다는 점에 유의하세요.

스크롤 가능한 텍스트 영역

예를 들어 전체 애플리케이션 페이지를 덮는 경우와 같이 TextArea를 스크롤 가능하게 만들려면 ScrollView 안에 배치할 수 있습니다.

ScrollView {
    id: view
    anchors.fill: parent

    TextArea {
        text: "TextArea\n...\n...\n...\n...\n...\n...\n"
    }
}

ScrollView 안에 배치된 텍스트 영역은 다음을 수행합니다:

  • 콘텐츠 크기를 자동으로 설정합니다.
  • 배경 장식이 제자리에 유지되도록 합니다.
  • 콘텐츠 잘라내기

탭 초점

기본적으로 TextArea에 active focus 가 있는 상태에서 탭 키를 누르면 탭 문자가 컨트롤 자체에 입력됩니다. 탭이 활성 포커스를 다른 항목으로 전달하도록 하려면 첨부된 KeyNavigation 속성을 사용합니다:

TextField {
    id: textField
}

TextArea {
    KeyNavigation.priority: KeyNavigation.BeforeItem
    KeyNavigation.tab: textField
}

TextField, 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.TabFocusReasonTab 키를 눌렀습니다.
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)]

이 속성은 텍스트 영역에서 마우스오버 이벤트를 허용할지 여부를 결정합니다. 기본값은 true 입니다.

이 속성은 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

이 속성은 사용자가 값을 입력하기 전에 텍스트 영역에 표시되는 짧은 힌트를 저장합니다.


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


첨부 속성 문서

TextArea.flickable : TextArea

이 속성은 텍스트 영역을 Flickable 에 첨부합니다.

ScrollBar, ScrollIndicator, Scrollable TextArea 를참조하십시오 .


신호 문서

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.