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

テキス ト 領域を ス ク ロール可能に し たい と き は、 た と えばそれがアプ リ ケーシ ョ ンページ全体を覆っ てい る と き は、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も参照してください 。

Attached Property ドキュメント

TextArea.flickable : TextArea

このプロパティは、テキスト領域をFlickable にアタッチします。

ScrollBar,ScrollIndicator,Scrollable TextAreaも参照 。

シグナル・ドキュメント

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