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も参照してください 。
ここに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
