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はTextEdit を継承し、placeholder text 機能を備え、装飾を追加しています。

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は、以下の動作を行います：

• コンテンツサイズを自動的に設定します
• 背景の装飾が所定の位置に固定される
• コンテンツをクリップする

Tabキーによるフォーカス

デフォルトでは、TextAreaにactive focus が設定されている状態でTabキーを押すと、コントロール自体にタブ文字が入力されます。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も参照してください 。