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 の背景の装飾はスクロール可能なコンテンツの残りの部分と一緒にスクロールすることに注意してください。

スクロール可能な 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

このプロパティは背景項目を保持する。

注意： 背景アイテムのサイズが明示的に指定されていない場合、自動的にコントロールのサイズに従います。ほとんどの場合、背景項目の幅や高さを指定する必要はない。

注意： ほとんどのコントロールは、コントロール自体の暗黙のサイズを計算するために、背景アイテムの暗黙のサイズを使用する。背景アイテムをカスタムアイテムに置き換える場合は、そのアイテムに適切な暗黙のサイズを指定することも考慮する必要があります（Image のように、独自の暗黙のサイズを持っているアイテムを除きます）。

TextAreaのカスタマイズも参照してください 。


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.TabFocusReasonTab キーが押された。
Qt.BacktabFocusReasonバックタブが発生した。この入力には、ShiftキーまたはControlキーが含まれます。
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 も参照して ください。


Attached Property ドキュメント

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.