Back to Qt.io
Contact Us Blog Download Qt

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

このプロパティは、ボタン内の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

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

text 、display 、および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

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

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

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 。


[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() も参照して ください。


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