【QML】復(fù)選框 CheckBox

import QtQuick.Controls 2.5
https://doc.qt.io/qt-5/videos/qtquickcontrols2-checkbox.mp4
CheckBox提供了一個可以切換(選中)或關(guān)閉(未選中)的選項按鈕荧恍。復(fù)選框通常用于從一組選項中選擇一個或多個選項拙寡。對于較大的選項集冈在,例如列表中的選項赐写,請考慮使用CheckDelegate搪花。

CheckBoxAbstractButton 繼承其 API。例如赞赖,可以使用 checked 屬性設(shè)置復(fù)選框的狀態(tài)咱枉。

除了已檢查和未檢查的狀態(tài)之外,還有第三種狀態(tài):部分檢查球昨《辏可以使用 tristate 屬性啟用部分檢查狀態(tài)。該狀態(tài)表示無法確定常規(guī)檢查/未檢查狀態(tài);通常是因為影響復(fù)選框的其他狀態(tài)主慰。例如嚣州,當(dāng)在樹視圖中選擇了多個子節(jié)點時,此狀態(tài)很有用河哑。

Hierarchical checkbox groups can be managed with a non-exclusive ButtonGroup.

以下示例說明了如何將子項的組合檢查狀態(tài)綁定到父復(fù)選框的檢查狀態(tài):

Column {
    ButtonGroup {
        id: childGroup
        exclusive: false
        checkState: parentBox.checkState
    }

    CheckBox {
        id: parentBox
        text: qsTr("Parent")
        checkState: childGroup.checkState
    }

    CheckBox {
        checked: true
        text: qsTr("Child 1")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }

    CheckBox {
        text: qsTr("Child 2")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }
}

屬性:

  • checkState : enumeration
    控制 復(fù)選框的狀態(tài)

    • 取值
      Constant Description
      Qt.Unchecked The checkbox is unchecked.
      Qt.PartiallyChecked The checkbox is partially checked. This state is only used when tristate is enabled.
      Qt.Checked The checkbox is checked.
    • See also tristate and checked.
  • nextCheckState:函數(shù)
    此屬性包含一個回調(diào)函數(shù)避诽,只要用戶通過觸摸,鼠標(biāo)或鍵盤交互切換復(fù)選框璃谨,就會調(diào)用該函數(shù)來確定下一個檢查狀態(tài)沙庐。
    默認(rèn)情況下,正常復(fù)選框在 Qt.UncheckedQt.Checked 狀態(tài)之間循環(huán)佳吞,并且三態(tài)復(fù)選框在 Qt.Unchecked拱雏,Qt.PartiallyCheckedQt.Checked 狀態(tài)之間循環(huán)。
    nextCheckState 回調(diào)函數(shù)可以覆蓋默認(rèn)行為底扳。以下示例實現(xiàn)了一個三態(tài)復(fù)選框铸抑,該復(fù)選框可以根據(jù)外部條件呈現(xiàn)部分檢查狀態(tài),但在用戶交互式切換時從不循環(huán)到部分檢查狀態(tài)衷模。

    CheckBox {
        tristate: true
        checkState: allChildrenChecked ? Qt.Checked :
            anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked
        nextCheckState: function() {
            if (checkState === Qt.Checked)
                return Qt.Unchecked
            else
                return Qt.Checked
        }
    }
    

    This property was introduced in QtQuick.Controls 2.4 (Qt 5.11).

  • tristate:(bool鹊汛。默認(rèn) false)表示復(fù)選框是否為三態(tài)蒲赂,默認(rèn)只有兩種狀態(tài)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市刁憋,隨后出現(xiàn)的幾起案子滥嘴,更是在濱河造成了極大的恐慌,老刑警劉巖至耻,帶你破解...
    沈念sama閱讀 211,042評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件若皱,死亡現(xiàn)場離奇詭異,居然都是意外死亡尘颓,警方通過查閱死者的電腦和手機走触,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,996評論 2 384
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來疤苹,“玉大人互广,你說我怎么就攤上這事∥酝粒” “怎么了兜辞?”我有些...
    開封第一講書人閱讀 156,674評論 0 345
  • 文/不壞的土叔 我叫張陵,是天一觀的道長夸溶。 經(jīng)常有香客問我,道長凶硅,這世上最難降的妖魔是什么缝裁? 我笑而不...
    開封第一講書人閱讀 56,340評論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮足绅,結(jié)果婚禮上捷绑,老公的妹妹穿的比我還像新娘。我一直安慰自己氢妈,他們只是感情好粹污,可當(dāng)我...
    茶點故事閱讀 65,404評論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著首量,像睡著了一般壮吩。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上加缘,一...
    開封第一講書人閱讀 49,749評論 1 289
  • 那天鸭叙,我揣著相機與錄音,去河邊找鬼拣宏。 笑死沈贝,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的勋乾。 我是一名探鬼主播宋下,決...
    沈念sama閱讀 38,902評論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼嗡善,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了学歧?” 一聲冷哼從身側(cè)響起罩引,我...
    開封第一講書人閱讀 37,662評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎撩满,沒想到半個月后蜒程,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,110評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡伺帘,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,451評論 2 325
  • 正文 我和宋清朗相戀三年昭躺,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片伪嫁。...
    茶點故事閱讀 38,577評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡领炫,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出张咳,到底是詐尸還是另有隱情帝洪,我是刑警寧澤,帶...
    沈念sama閱讀 34,258評論 4 328
  • 正文 年R本政府宣布脚猾,位于F島的核電站葱峡,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏龙助。R本人自食惡果不足惜砰奕,卻給世界環(huán)境...
    茶點故事閱讀 39,848評論 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望提鸟。 院中可真熱鬧军援,春花似錦、人聲如沸称勋。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,726評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽赡鲜。三九已至空厌,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間银酬,已是汗流浹背蝇庭。 一陣腳步聲響...
    開封第一講書人閱讀 31,952評論 1 264
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留捡硅,地道東北人哮内。 一個月前我還...
    沈念sama閱讀 46,271評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親北发。 傳聞我的和親對象是個殘疾皇子纹因,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,452評論 2 348