AbstractButton QML Type

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

• 継承されたメンバを含む全メンバのリスト

プロパティ

• 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)
• 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 つだけで、別のボタンをチェックすると、前にチェックしたボタンのチェックは自動的に解除されます。

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 がボタン内にどのように表示されるかを決定します。

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

spacing とpaddingも参照してください 。

down : bool

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

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

pressedも参照してください 。

icon group

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

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 シグナルを発するはずだがマウスカーソルがボタンの中にない時に発せられる。

clicked()

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

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

doubleClicked()

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

pressAndHold()

このシグナルは、ユーザーがタッチやマウスを使ってインタラクティブにボタンを押し続けたときに発せられる。autoRepeat が有効な場合は発せられない。

pressed()

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

released()

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

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

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

このシグナルは 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()も参照 。