TextField QML Type
一行テキスト入力フィールド。詳細...
| 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 | バックタブが発生した。この入力には、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)]
このプロパティは、テキストフィールドがホバーイベントを受け入れるかどうかを決定します。デフォルト値は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も参照してください 。
Signal ドキュメント
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も参照してください 。
© 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.


