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も参照してください 。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。