AbstractButton QML Type

ボタンに共通する機能を提供する抽象的な基本型。詳細...

Import Statement: import QtQuick.Controls
Inherits:

Control

Inherited By:

Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton

プロパティ

信号

方法

詳細説明

AbstractButton は、ボタンのような振る舞いをするコントロール、例えば、プッシュボタンや、ラジオボタンやチェックボックスのようなチェック可能なコントロールのためのインターフェイスを提供します。抽象コントロールであるため、デリゲートの実装はなく、派生する型に委ねられます。

ButtonGroup およびButton Controlsも参照してください

プロパティの説明

action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティは、ボタンのアクションを保持します。

このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

Actionも参照して ください。


autoExclusive : bool

このプロパティは、自動排他性が有効かどうかを保持します。

自動排他性が有効な場合、同じ親アイテムに属するチェック可能ボタンは、同じButtonGroup に属しているかのように動作します。常にチェックできるボタンは1つだけで、別のボタンをチェックすると、前にチェックしたボタンのチェックは自動的に解除されます。

注意: このプロパティは、ButtonGroup に属するボタンには影響しません。

RadioButton と はデフォルトで自動排他的です。TabButton


autoRepeat : bool

このプロパティは、ボタンが押下され続けている間、ボタンがpressed()、released()、clicked() のシグナルを繰り返すかどうかを保持します。

このプロパティをtrue に設定すると、pressAndHold() シグナルは出力されません。

デフォルト値はfalse である。

初期遅延時間および繰り返し間隔は、autoRepeatDelay およびautoRepeatInterval によってミリ秒単位で定義される。


autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]

このプロパティは、自動繰り返しの初期遅延をミリ秒単位で保持する。デフォルト値は300 ms です。

このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。

autoRepeat およびautoRepeatIntervalも参照してください


autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]

このプロパティは、自動繰り返しの間隔をミリ秒単位で保持します。デフォルト値は100 ms です。

このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。

autoRepeat およびautoRepeatDelayも参照してください


checkable : bool

このプロパティは、ボタンがチェック可能かどうかを保持します。

チェック可能なボタンは、ボタンにアクティブなフォーカスがある状態で、ユーザーがボタンをクリックするか、スペースバーを押すと、チェックあり(オン)とチェックなし(オフ)が切り替わります。

デフォルト値はfalse です。

checkedも参照してください


checked : bool

このプロパティは、ボタンがチェックされているかどうかを保持します。

Qt 6.2 以降、このプロパティを設定してもcheckable プロパティには影響しなくなりました。必要であれば、checkable プロパティを明示的に設定してください。

checkableも参照してください


display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティは、ボタン内のicontext の表示方法を決定します。

表示結果
AbstractButton.IconOnly

AbstractButton.TextOnly

AbstractButton.TextBesideIcon (デフォルト)

AbstractButton.TextUnderIcon

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

spacingpaddingも参照してください


down : bool

このプロパティは、ボタンが視覚的に押下されているかどうかを保持します。

明示的に設定しない限り、このプロパティはpressed の値に従います。 デフォルト値に戻すには、このプロパティをundefined に設定します。

pressedも参照してください


icon group

icon.cache : bool

icon.color : color

icon.height : int

icon.name : string

icon.source : url

icon.width : int

このプロパティグループは、QtQuick.Controls 2.3 で追加されました。

名前説明
名前このプロパティは、使用するアイコンの名前を保持します。

アイコンはプラットフォームのテーマから読み込まれます。アイコンがテーマにある場合は、icon.source が設定されていても、常にそのアイコンを使用します。アイコンが見つからない場合は、icon.source

テーマ・アイコンの詳細については、QIcon::fromTheme()を参照のこと。

ソースこのプロパティは、使用するアイコンの名前を保持します。

アイコンは通常の画像として読み込まれます。

icon.name が設定され、有効なテーマアイコンを参照している場合、このプロパティの代わりに常にそのアイコンが使用されます。

このプロパティはアイコンの幅を保持する。

アイコンの幅がこの値を超えることはありませんが、必要に応じて縮小されます。

高さこのプロパティはアイコンの高さを保持します。

アイコンの高さがこの値を超えることはありませんが、必要に応じて縮小されます。

このプロパティはアイコンの色を保持する。

色が"transparent" に設定されていない限り、アイコンは指定された色で着色されます。

キャッシュこのプロパティは、アイコンをキャッシュするかどうかを指定します。

デフォルト値はtrueである。

詳細については、cache を参照してください。

このプロパティはQtQuick.Controls 2.13 で導入されました。

textdisplay 、および Qt Quick Controls の Iconsも参照してください


implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙のインジケータの高さを保持する。

値はindicator ? indicator.implicitHeight : 0 に等しい。

これは通常、implicitContentHeight およびimplicitBackgroundHeight とともに、implicitHeight を計算するために使用されます。

このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。

implicitIndicatorWidthも参照してください


implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙のインジケータの幅を保持します。

値はindicator ? indicator.implicitWidth : 0 と等しくなります。

これは通常、implicitContentWidth およびimplicitBackgroundWidth とともに、implicitWidth を計算するために使用されます。

このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。

implicitIndicatorHeightも参照してください


indicator : Item

このプロパティは、インジケータ項目を保持します。


pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]

このプロパティは、最後に押された位置の x 座標を保持します。

注意: 値はタッチ移動時に更新されますが、タッチを離した後はそのまま残ります。

このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。

pressYも参照してください


pressY : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]

このプロパティは、最後に押された位置のy座標を保持します。

注意: この値はタッチ移動時に更新されますが、タッチを離した後はそのまま残ります。

このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。

pressXも参照してください


pressed : bool [read-only]

このプロパティは、ボタンが物理的に押されているかどうかを保持します。ボタンは、タッチイベントでもキーイベントでも押されます。

down参照して ください。


text : string

このプロパティは、ボタンのテキストによる説明を保持します。

注: テキストはアクセシビリティのために使用されるので、コンテンツアイテムが画像であっても、テキストの説明を設定することは理にかなっています。

icondisplaycontentItemも参照


シグナル・ドキュメント

canceled()

このシグナルは、ボタンが押されている間にマウスを掴めなくなったとき、または、released シグナルが発せられるはずだが、マウスカーソルがボタンの中にないときに発せられる。

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


clicked()

このシグナルは、ボタンがタッチ、マウス、キーボードによってユーザーによってインタラクティブにクリックされたときに発せられます。

注: 対応するハンドラはonClicked

click(),animateClick(), およびCall a C++ function from QML when a Button is clicked参照して ください。


doubleClicked()

このシグナルはボタンがタッチやマウスによってインタラクティブにダブルクリックされたときに発せられる。

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


pressAndHold()

このシグナルはタッチ操作やマウス操作によってボタンが押下されたときに出力されます。autoRepeat が有効な場合は発せられません。

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


pressed()

このシグナルは、タッチ、マウス、またはキーボードによってユーザーがインタラクティブにボタンを押したときに発せられます。

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


released()

このシグナルは、タッチ、マウス、またはキーボードによってユーザーがインタラクティブにボタンを離したときに発せられます。

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


[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()

このシグナルは、チェック可能なボタンがタッチ、マウス、キーボードによってユーザーによってインタラクティブに切り替えられたときに発せられる。

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

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


メソッドのドキュメント

[since Qt 6.8] void animateClick()

ボタンを押してから離すまでに100ミリ秒の遅延があり、その過程で視覚的な状態をアニメーション化しながら、ボタンがクリックされるのをシミュレートします。

クリックに関連するすべてのシグナルが適切に発せられます。

focusPolicyQt.ClickFocus を含む場合、activeFocustrue になります。

ボタンがdisabled の場合、この関数は何もしません。

ボタンがリリースされる前にこの関数を再度呼び出すと、リリースタイマーがリセットされます。

このメソッドは Qt 6.8 で導入されました。

click(),pressed(),released(),clicked()も参照してください


[since Qt 6.8] void click()

押してから離すまでの間に遅延がない状態でボタンがクリックされるのをシミュレートします。

クリックに関連するすべてのシグナルが適切に発せられます。

focusPolicyQt.ClickFocus が含まれている場合、activeFocustrue になります。

ボタンがdisabled の場合、この関数は何もしません。

ボタンがリリースされる前にこの関数を再度呼び出すと、リリースタイマーがリセットされます。

このメソッドは Qt 6.8 で導入されました。

animateClick(),pressed(),released(),clicked()も参照してください


void toggle()

ボタンのチェック状態を切り替えます。

click() およびanimateClick() も参照して ください。


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