diff options
Diffstat (limited to 'library/gingerbread/src/com/android/setupwizardlib/items/SwitchItem.java')
-rw-r--r-- | library/gingerbread/src/com/android/setupwizardlib/items/SwitchItem.java | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/library/gingerbread/src/com/android/setupwizardlib/items/SwitchItem.java b/library/gingerbread/src/com/android/setupwizardlib/items/SwitchItem.java new file mode 100644 index 0000000..7459d77 --- /dev/null +++ b/library/gingerbread/src/com/android/setupwizardlib/items/SwitchItem.java @@ -0,0 +1,133 @@ +/* + * Copyright (C) 2015 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.android.setupwizardlib.items; + +import android.content.Context; +import android.content.res.TypedArray; +import android.support.v7.widget.SwitchCompat; +import android.util.AttributeSet; +import android.view.View; +import android.widget.CompoundButton; + +import com.android.setupwizardlib.R; + +/** + * An item that is displayed with a switch, with methods to manipulate and listen to the checked + * state of the switch. Note that by default, only click on the switch will change the on-off state. + * To change the switch state when tapping on the text, use the click handlers of list view or + * RecyclerItemAdapter with {@link #toggle(View)}. + */ +public class SwitchItem extends Item implements CompoundButton.OnCheckedChangeListener { + + /** + * Listener for check state changes of this switch item. + */ + public interface OnCheckedChangeListener { + + /** + * Callback when checked state of a {@link SwitchItem} is changed. + * + * @see #setOnCheckedChangeListener(OnCheckedChangeListener) + */ + void onCheckedChange(SwitchItem item, boolean isChecked); + } + + private boolean mChecked = false; + private OnCheckedChangeListener mListener; + + /** + * Creates a default switch item. + */ + public SwitchItem() { + super(); + } + + /** + * Creates a switch item. This constructor is used for inflation from XML. + * + * @param context The context which this item is inflated in. + * @param attrs The XML attributes defined on the item. + */ + public SwitchItem(Context context, AttributeSet attrs) { + super(context, attrs); + final TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.SuwSwitchItem); + mChecked = a.getBoolean(R.styleable.SuwSwitchItem_android_checked, false); + a.recycle(); + } + + /** + * Sets whether this item should be checked. + */ + public void setChecked(boolean checked) { + if (mChecked != checked) { + mChecked = checked; + notifyItemChanged(); + if (mListener != null) { + mListener.onCheckedChange(this, checked); + } + } + } + + /** + * @return True if this switch item is currently checked. + */ + public boolean isChecked() { + return mChecked; + } + + @Override + protected int getDefaultLayoutResource() { + return R.layout.suw_items_switch; + } + + /** + * Toggle the checked state of the switch, without invalidating the entire item. + * + * @param view The root view of this item, typically from the argument of onItemClick. + */ + public void toggle(View view) { + mChecked = !mChecked; + final SwitchCompat switchView = (SwitchCompat) view.findViewById(R.id.suw_items_switch); + switchView.setChecked(mChecked); + } + + @Override + public void onBindView(View view) { + super.onBindView(view); + final SwitchCompat switchView = (SwitchCompat) view.findViewById(R.id.suw_items_switch); + switchView.setOnCheckedChangeListener(null); + switchView.setChecked(mChecked); + switchView.setOnCheckedChangeListener(this); + switchView.setEnabled(isEnabled()); + } + + /** + * Sets a listener to listen for changes in checked state. This listener is invoked in both + * user toggling the switch and calls to {@link #setChecked(boolean)}. + */ + public void setOnCheckedChangeListener(OnCheckedChangeListener listener) { + mListener = listener; + } + + @Override + public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { + mChecked = isChecked; + if (mListener != null) { + mListener.onCheckedChange(this, isChecked); + } + } +} |