切換鈕

切換鈕可讓使用者在兩個狀態之間變更設定。

使用 ToggleButton 物件,即可在版面配置中加入基本切換鈕。Android 4.0 (API 級別 14) 推出了另一種稱為「切換開關」的切換鈕,其可提供滑桿控制項,您可以透過 Switch 物件新增滑桿控制項。SwitchCompat 是切換開關小工具的一種版本,可以支援 API 級別 7 以上的裝置。

如果您需要自行變更按鈕的狀態,可使用 CompoundButton.setChecked()CompoundButton.toggle() 方法。

切換鈕

切換開關 (Android 4.0 以上版本)

主要類別如下:

回應按鈕動作

如要偵測使用者何時啟動按鈕或切換開關,請建立 CompoundButton.OnCheckedChangeListener 物件,並透過呼叫 setOnCheckedChangeListener() 將其指派至該按鈕。例如:

Kotlin

val toggle: ToggleButton = findViewById(R.id.togglebutton)
toggle.setOnCheckedChangeListener { _, isChecked ->
    if (isChecked) {
        // The toggle is enabled
    } else {
        // The toggle is disabled
    }
}

Java

ToggleButton toggle = (ToggleButton) findViewById(R.id.togglebutton);
toggle.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
    public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
        if (isChecked) {
            // The toggle is enabled
        } else {
            // The toggle is disabled
        }
    }
});