TextField QML Type
1行のテキスト入力フィールド。詳細...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
プロパティ
- 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))
信号
- 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))
詳細な説明
TextFieldは、1行のテキストエディタです。TextFieldはTextInput を継承し、placeholder text 機能を備え、装飾を追加しています。
| 通常状態のテキストフィールド。 |
| フォーカスがアクティブなテキストフィールド。 |
| 無効化されたテキストフィールド。 |
TextField {
placeholderText: qsTr("Enter name")
}「 TextArea 」、「TextFieldのカスタマイズ」、および「入力コントロール」も参照してください 。
プロパティのドキュメント
background : Item
このプロパティは、背景アイテムを保持します。
注: 背景アイテムに明示的なサイズが指定されていない場合 、自動的にコントロールのサイズに従います。ほとんどの場合、背景アイテムの幅や高さを指定する必要はありません。
注: ほとんどの コントロールは 、背景項目の暗黙的なサイズを使用して、コントロール自体の暗黙的なサイズを計算します。背景項目をカスタム項目に置き換える場合は、その項目に対して適切な暗黙的なサイズを設定することも検討する必要があります(Image のように、独自の暗黙的なサイズを持つ項目を除く)。
「TextFieldのカスタマイズ」も参照してください 。
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.TabFocusReason | Tab キーが押されました。 |
Qt.BacktabFocusReason | Backtab が発生しました。この入力には、Shift キーや Control キーが含まれる場合があります(例:Shift+Tab)。 |
Qt.ActiveWindowFocusReason | ウィンドウシステムによって、このウィンドウがアクティブまたは非アクティブになりました。 |
Qt.PopupFocusReason | アプリケーションが、キーボードのフォーカスを取得/解放するポップアップを開いた/閉じた。 |
Qt.ShortcutFocusReason | ユーザーがラベルのバディショートカットを入力しました |
Qt.MenuBarFocusReason | メニューバーがフォーカスを獲得しました。 |
Qt.OtherFocusReason | その他の理由(通常はアプリケーション固有)。 注: このプロパティよりも、QtQuick.Controls::Control::focusReason を使用することを推奨します 。 |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
このプロパティは、テキストフィールドがホバーイベントを受け付けるかどうかを決定します。デフォルト値はfalse です。
このプロパティは、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
このプロパティには、ユーザーがテキストを入力する前に「TextField 」に表示されるヒントが格納されています。
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も参照してください 。
シグナルのドキュメント
pressAndHold(MouseEvent event)
このシグナルは、長押しが行われたときに発信されます(遅延時間はプラットフォームプラグインによって異なります)。event パラメータは、押された位置のx座標とy座標、およびどのボタンが押されたかといった、押下に関する情報を提供します。
注: 対応するハンドラは `onPressAndHold` です。
[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も参照してください 。
© 2026 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.


