このページでは

TextField QML Type

一行テキスト入力フィールド。詳細...

Import Statement: import QtQuick.Controls
Inherits:

TextInput

プロパティ

信号

  • 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 はTextInputplaceholder text 機能で拡張し、装飾を追加したものです。

通常状態のテキスト・フィールド

通常の状態のテキストフィールド。

テキストフィールドがハイライトされたフォーカス状態

アクティブフォーカスを持つテキストフィールド。

無効状態のテキスト・フィールド

無効になっているテキストフィールド。
TextField {
    placeholderText: qsTr("Enter name")
}

TextAreaTextField のカスタマイズ入力コントロールも参照

プロパティ文書

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.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)]

このプロパティは、テキストフィールドがホバーイベントを受け入れるかどうかを決定します。デフォルト値は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 LayoutbottomInsetも参照してください

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) で導入されました。

releasedpressAndHoldも参照してください

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

このシグナルは、テキストフィールドがユーザーによってリリースされたときに発せられます。event パラメータは、押された x 座標と y 座標、どのボタンが押されたかを含む、リリースに関する情報を提供します。

注: 対応するハンドラはonReleased です。

このシグナルは QtQuick.Controls 2.1 (Qt 5.8) で導入されました。

pressedpressAndHoldも参照してください

© 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.