TextArea QML Type

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

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

속성

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

연관 속성

• flickable : TextArea

신호

• 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는 placeholder text 기능을 갖춘 TextEdit 를 상속하며, 장식 요소를 추가합니다.

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

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

스크롤 가능한 TextArea

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

ScrollView {
    id: view
    anchors.fill: parent

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

ScrollView 내부에 배치된 TextArea는 다음과 같이 동작합니다:

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

탭 포커스

기본적으로 TextArea에 active focus 가 적용된 상태에서 Tab 키를 누르면 컨트롤 자체에 탭 문자가 입력됩니다. 탭 키를 눌러 활성 포커스를 다른 항목으로 이동시키려면, 다음 KeyNavigation 속성을 사용하십시오:

TextField {
    id: textField
}

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

TextField, TextArea 사용자 지정 및 입력 컨트롤항목도 참조하십시오 .

속성 설명서

background : Item

이 속성은 배경 항목을 포함합니다.

'TextArea 사용자 정의' 항목도 참조하십시오 .

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

이 속성은 배경의 하단 여백을 지정합니다.

이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.

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

focusReason : enumeration

이 속성은 마지막 포커스 변경의 원인을 나타냅니다.

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 [attached]

이 속성은 ` Flickable`에 텍스트 영역을 연결합니다.

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

Signal 문서

pressAndHold(MouseEvent event)

이 신호는 길게 누를 때 발생합니다(지연 시간은 플랫폼 플러그인에 따라 다릅니다). event 매개변수는 누른 위치의 x, y 좌표와 누른 버튼 정보를 포함하여 누름 동작에 대한 정보를 제공합니다.

pressed 및 released도 참조하십시오 .

[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)

이 신호는 사용자가 텍스트 영역을 눌렀을 때 발생합니다. event 매개변수는 눌린 위치의 x, y 좌표와 어떤 버튼이 눌렸는지를 포함한 누름 관련 정보를 제공합니다.

이 신호는 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.

released 및 pressAndHold도 참조하십시오 .

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

이 신호는 사용자가 텍스트 영역에서 손가락을 떼면 발생합니다. ` event ` 매개변수는 누른 위치의 x, y 좌표와 누른 버튼 정보 등 손가락을 뗀 동작에 대한 정보를 제공합니다.

이 신호는 QtQuick.Controls 2.1(Qt 5.8)에서 도입되었습니다.

pressed 및 pressAndHold도 참조하십시오 .