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 |
このプロパティは、背景のボトムインセットを保持します。
このプロパティは 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 |
このプロパティは、テキストフィールドがホバーイベントを受け入れるかどうかを決定します。デフォルト値はfalse です。
このプロパティは、QtQuick.Controls 2.1（Qt 5.8）で導入されました。
hoveredも参照してください 。
hovered : bool |
このプロパティは、テキストフィールドがホバーされているかどうかを保持します。
このプロパティは QtQuick.Controls 2.1 (Qt 5.8) で導入されました。
hoverEnabled も参照して ください。
implicitBackgroundHeight : real |
このプロパティは、暗黙の背景の高さを保持します。
値はbackground ? background.implicitHeight : 0 と同じです。
このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
implicitBackgroundWidthも参照してください 。
implicitBackgroundWidth : real |
このプロパティは、暗黙の背景の幅を保持します。
値はbackground ? background.implicitWidth : 0 に等しい。
このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
implicitBackgroundHeightも参照してください 。
leftInset : real |
このプロパティは、背景の左インセットを保持します。
このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
Control Layout およびrightInset も参照して ください。
placeholderTextColor : color |
このプロパティは、placeholderText の色を保持します。
このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
placeholderTextも参照してください 。
rightInset : real |
このプロパティは、背景の右インセットを保持します。
このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
Control Layout およびleftInset も参照して ください。
topInset : real |
このプロパティは、背景の上部インセットを保持します。
このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
Control Layout とbottomInset も参照して ください。
シグナル ドキュメント
pressAndHold(MouseEvent event) |
|
このシグナルは、テキスト・フィールドがユーザーによって押されたときに発せられる。event パラメータは、押されたときの x 座標と y 座標、どのボタンが押されたかを含む、押されたときの情報を提供します。
注: 対応するハンドラはonPressed です。
このシグナルは QtQuick.Controls 2.1 (Qt 5.8) で導入されました。
released とpressAndHoldも参照してください 。
|
このシグナルは、テキストフィールドがユーザーによってリリースされたときに発せられます。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.
