AbstractButton QML Type
ボタンに共通する機能を提供する抽象的な基本型。詳細...
Import Statement: | import QtQuick.Controls |
Inherits: | |
Inherited By: | Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton |
プロパティ
- 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
- icon.cache : bool
- icon.color : color
- icon.height : int
- icon.name : string
- icon.source : url
- icon.width : int
- 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 |
autoExclusive : bool |
このプロパティは、自動排他性が有効かどうかを保持します。
自動排他性が有効な場合、同じ親アイテムに属するチェック可能ボタンは、同じButtonGroup に属しているかのように動作します。常にチェックできるボタンは1つだけで、別のボタンをチェックすると、前にチェックしたボタンのチェックは自動的に解除されます。
注意: このプロパティは、ButtonGroup に属するボタンには影響しません。
RadioButton と はデフォルトで自動排他的です。TabButton
autoRepeat : bool |
このプロパティは、ボタンが押下され続けている間、ボタンがpressed()、released()、clicked() のシグナルを繰り返すかどうかを保持します。
このプロパティをtrue
に設定すると、pressAndHold() シグナルは出力されません。
デフォルト値はfalse
である。
初期遅延時間および繰り返し間隔は、autoRepeatDelay およびautoRepeatInterval によってミリ秒単位で定義される。
autoRepeatDelay : int |
このプロパティは、自動繰り返しの初期遅延をミリ秒単位で保持する。デフォルト値は300
ms です。
このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。
autoRepeat およびautoRepeatIntervalも参照してください 。
autoRepeatInterval : int |
このプロパティは、自動繰り返しの間隔をミリ秒単位で保持します。デフォルト値は100
ms です。
このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。
autoRepeat およびautoRepeatDelayも参照してください 。
checkable : bool |
このプロパティは、ボタンがチェック可能かどうかを保持します。
チェック可能なボタンは、ボタンにアクティブなフォーカスがある状態で、ユーザーがボタンをクリックするか、スペースバーを押すと、チェックあり(オン)とチェックなし(オフ)が切り替わります。
デフォルト値はfalse
です。
checkedも参照してください 。
checked : bool |
display : enumeration |
down : bool |
このプロパティグループは、QtQuick.Controls 2.3 で追加されました。
名前 | 説明 |
---|---|
名前 | このプロパティは、使用するアイコンの名前を保持します。 アイコンはプラットフォームのテーマから読み込まれます。アイコンがテーマにある場合は、icon.source が設定されていても、常にそのアイコンを使用します。アイコンが見つからない場合は、icon.source 。 テーマ・アイコンの詳細については、QIcon::fromTheme()を参照のこと。 |
ソース | このプロパティは、使用するアイコンの名前を保持します。 アイコンは通常の画像として読み込まれます。 icon.name が設定され、有効なテーマアイコンを参照している場合、このプロパティの代わりに常にそのアイコンが使用されます。 |
幅 | このプロパティはアイコンの幅を保持する。 アイコンの幅がこの値を超えることはありませんが、必要に応じて縮小されます。 |
高さ | このプロパティはアイコンの高さを保持します。 アイコンの高さがこの値を超えることはありませんが、必要に応じて縮小されます。 |
色 | このプロパティはアイコンの色を保持する。 色が |
キャッシュ | このプロパティは、アイコンをキャッシュするかどうかを指定します。 デフォルト値はtrueである。 詳細については、cache を参照してください。 このプロパティはQtQuick.Controls 2.13 で導入されました。 |
text 、display 、および Qt Quick Controls の Iconsも参照してください 。
implicitIndicatorHeight : real |
このプロパティは、暗黙のインジケータの高さを保持する。
値はindicator ? indicator.implicitHeight : 0
に等しい。
これは通常、implicitContentHeight およびimplicitBackgroundHeight とともに、implicitHeight を計算するために使用されます。
このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。
implicitIndicatorWidthも参照してください 。
implicitIndicatorWidth : real |
このプロパティは、暗黙のインジケータの幅を保持します。
値はindicator ? indicator.implicitWidth : 0
と等しくなります。
これは通常、implicitContentWidth およびimplicitBackgroundWidth とともに、implicitWidth を計算するために使用されます。
このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。
implicitIndicatorHeightも参照してください 。
indicator : Item |
このプロパティは、インジケータ項目を保持します。
pressX : real |
このプロパティは、最後に押された位置の x 座標を保持します。
注意: 値はタッチ移動時に更新されますが、タッチを離した後はそのまま残ります。
このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。
pressYも参照してください 。
pressY : real |
このプロパティは、最後に押された位置のy座標を保持します。
注意: この値はタッチ移動時に更新されますが、タッチを離した後はそのまま残ります。
このプロパティは QtQuick.Controls 2.4 (Qt 5.11) で導入されました。
pressXも参照してください 。
pressed : bool |
このプロパティは、ボタンが物理的に押されているかどうかを保持します。ボタンは、タッチイベントでもキーイベントでも押されます。
down も参照して ください。
text : string |
このプロパティは、ボタンのテキストによる説明を保持します。
注: テキストはアクセシビリティのために使用されるので、コンテンツアイテムが画像であっても、テキストの説明を設定することは理にかなっています。
icon 、display 、contentItemも参照 。
シグナル・ドキュメント
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
です。
|
このシグナルは、チェック可能なボタンがタッチ、マウス、キーボードによってユーザーによってインタラクティブに切り替えられたときに発せられる。
注: 対応するハンドラはonToggled
です。
このシグナルは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。
メソッドのドキュメント
|
ボタンを押してから離すまでに100ミリ秒の遅延があり、その過程で視覚的な状態をアニメーション化しながら、ボタンがクリックされるのをシミュレートします。
クリックに関連するすべてのシグナルが適切に発せられます。
focusPolicy がQt.ClickFocus
を含む場合、activeFocus はtrue
になります。
ボタンがdisabled の場合、この関数は何もしません。
ボタンがリリースされる前にこの関数を再度呼び出すと、リリースタイマーがリセットされます。
このメソッドは Qt 6.8 で導入されました。
|
押してから離すまでの間に遅延がない状態でボタンがクリックされるのをシミュレートします。
クリックに関連するすべてのシグナルが適切に発せられます。
focusPolicy がQt.ClickFocus
を含む場合、activeFocus はtrue
になります。
ボタンが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.