AbstractButton QML Type
ボタンに共通する機能を提供する抽象基底型。詳細...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: |
プロパティ
- action : Action
(since QtQuick.Controls 2.3 (Qt 5.10)) - autoExclusive : bool
- autoRepeat : bool
- autoRepeatDelay : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - autoRepeatInterval : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - checkable : bool
- checked : bool
- display : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - down : bool
- icon
(since QtQuick.Controls 2.3)- icon.cache : bool
(since QtQuick.Controls 2.3) - icon.color : color
(since QtQuick.Controls 2.3) - icon.height : int
(since QtQuick.Controls 2.3) - icon.name : string
(since QtQuick.Controls 2.3) - icon.source : url
(since QtQuick.Controls 2.3) - icon.width : int
(since QtQuick.Controls 2.3)
- icon.cache : bool
- implicitIndicatorHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitIndicatorWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - indicator : Item
- pressX : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressY : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressed : bool
- text : string
信号
- canceled()
- clicked()
- doubleClicked()
- pressAndHold()
- pressed()
- released()
- toggled()
(since QtQuick.Controls 2.2 (Qt 5.9))
方法
- void animateClick()
(since Qt 6.8) - void click()
(since Qt 6.8) - void toggle()
詳細な説明
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 ミリ秒です。
このプロパティは、QtQuick.Controls 2.4 (Qt 5.11) で導入されました。
「 autoRepeat 」および「autoRepeatInterval 」も参照してください 。
autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]
このプロパティは、自動リピートの間隔（ミリ秒単位）を保持します。デフォルト値は100 ミリ秒です。
このプロパティは、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)]
このプロパティは、ボタン内で「icon 」および「text 」がどのように表示されるかを決定します。
| 表示 | 表示結果 |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (デフォルト) |
|
AbstractButton.TextUnderIcon |
|
このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
「 spacing 」および「padding 」も参照してください 。
down : bool
このプロパティは、ボタンが視覚的に押下されているかどうかを表します。
明示的に設定されていない場合、このプロパティはpressed の値に従います。デフォルト値に戻すには、このプロパティをundefined に設定してください。
「pressed」も参照してください 。
icon group
icon.cache : bool [since QtQuick.Controls 2.3]
icon.color : color [since QtQuick.Controls 2.3]
icon.height : int [since QtQuick.Controls 2.3]
icon.name : string [since QtQuick.Controls 2.3]
icon.source : url [since QtQuick.Controls 2.3]
icon.width : int [since QtQuick.Controls 2.3]
| 名前 | 説明 |
|---|---|
| name | このプロパティには、使用するアイコンの名前が格納されます。 アイコンはプラットフォームのテーマから読み込まれます。テーマ内にアイコンが見つかった場合、icon.source が設定されていても、常にそのアイコンが使用されます。アイコンが見つからない場合は、代わりにicon.source が使用されます。 テーマアイコンの詳細については、QIcon::fromTheme() を参照してください。 |
| source | このプロパティには、使用するアイコンの名前を指定します。 アイコンは通常の画像として読み込まれます。 icon.name が設定されており、有効なテーマアイコンを参照している場合、このプロパティの代わりに常にそのアイコンが使用されます。 |
| width | このプロパティは、アイコンの幅を指定します。 アイコンの幅はこの値を超えることはありませんが、必要に応じて縮小されます。 |
| height | このプロパティは、アイコンの高さを指定します。 アイコンの高さはこの値を超えることはありませんが、必要に応じて縮小されます。 |
| color | このプロパティは、アイコンの色を指定します。 色が |
| cache | このプロパティは、アイコンをキャッシュするかどうかを指定します。 デフォルト値は true です。 詳細については、cache を参照してください。 このプロパティは、QtQuick.Controls 2.13 で導入されました。 |
これらのプロパティは、QtQuick.Controls 2.3で導入されました。
「 text 」、「display 」、および「 Qt Quick Controls」の「アイコン」も参照してください 。
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
このプロパティには、ボタンの説明文が格納されます。
注：このテキストは アクセシビリティの目的で使用されるため、コンテンツ項目が画像であっても、テキストによる説明を設定することが推奨されます。
関連項目： icon 、display 、およびcontentItem 。
Signal ドキュメント
canceled()
このシグナルは、ボタンが押された状態でマウスグラブが解除されたとき、または「released 」シグナルを発行するはずであるにもかかわらず、マウスカーソルがボタンの内部にない場合に発行されます。
注： 対応するハンドラは onCanceled です。
clicked()
このシグナルは、ユーザーがタッチ、マウス、またはキーボードを使用してボタンをインタラクティブにクリックしたときに発生します。
注： 対応するハンドラは `onClicked` です。
関連項目： click()、animateClick()、および「Buttonがクリックされた際にQMLからC++関数を呼び出す」も参照してください 。
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ミリ秒の遅延を設け、その過程でボタンの視覚的な状態をアニメーション表示します。
クリックに関連するすべてのシグナルが適切に発信されます。
focusPolicy にQt.ClickFocus が含まれている場合、activeFocus はtrue になります。
ボタンがdisabled の状態の場合、この関数は何も実行しません。
ボタンが離される前にこの関数を再度呼び出すと、リリースタイマーがリセットされます。
このメソッドは Qt 6.8 で導入されました。
click()、pressed()、released()、およびclicked()も参照してください 。
[since Qt 6.8] void click()
ボタンをクリックした状態をシミュレートし、押下から離すまでの間に遅延を生じさせません。
クリックに関連するすべてのシグナルが、適切に発信されます。
focusPolicy にQt.ClickFocus が含まれている場合、activeFocus はtrue となります。
ボタンがdisabled の状態の場合、この関数は何もしません。
ボタンが離される前にこの関数を再度呼び出すと、リリースタイマーがリセットされます。
このメソッドは Qt 6.8 で導入されました。
animateClick()、pressed()、released()、およびclicked()も参照してください 。
void toggle()
ボタンのチェック状態を切り替えます。
click() およびanimateClick()も参照してください 。
© 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.
