Merge "Move ActionButtonPreference into SettingsLib" (299a573c) · Commits · e / os / android_frameworks_base

packages/SettingsLib/ActionButtonsPreference/Android.bp

0 → 100644

+13 −0

Original line number	Diff line number	Diff line
		android_library {
		name: "ActionButtonsPreference",

		srcs: ["src/*/.java"],
		resource_dirs: ["res"],

		static_libs: [
		"androidx.preference_preference",
		],

		sdk_version: "system_current",
		min_sdk_version: "21",
		}

packages/SettingsLib/ActionButtonsPreference/AndroidManifest.xml

0 → 100644

+23 −0

Original line number	Diff line number	Diff line
		<?xml version="1.0" encoding="utf-8"?>
		<!--
		Copyright (C) 2018 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.
		-->

		<manifest xmlns:android="http://schemas.android.com/apk/res/android"
		package="com.android.settingslib.widget">

		<uses-sdk android:minSdkVersion="21" />

		</manifest>

packages/SettingsLib/ActionButtonsPreference/res/layout/settings_action_buttons.xml

0 → 100644

+52 −0

Original line number	Diff line number	Diff line
		<?xml version="1.0" encoding="utf-8"?>
		<!--
		Copyright (C) 2018 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.
		-->

		<LinearLayout
		xmlns:android="http://schemas.android.com/apk/res/android"
		android:layout_width="match_parent"
		android:layout_height="wrap_content"
		android:paddingStart="8dp"
		android:orientation="horizontal">

		<Button
		android:id="@+id/button1"
		style="@style/SettingsActionButton"
		android:layout_width="0dp"
		android:layout_height="wrap_content"
		android:layout_weight="1"/>

		<Button
		android:id="@+id/button2"
		style="@style/SettingsActionButton"
		android:layout_width="0dp"
		android:layout_height="wrap_content"
		android:layout_weight="1"/>

		<Button
		android:id="@+id/button3"
		style="@style/SettingsActionButton"
		android:layout_width="0dp"
		android:layout_height="wrap_content"
		android:layout_weight="1"/>

		<Button
		android:id="@+id/button4"
		style="@style/SettingsActionButton"
		android:layout_width="0dp"
		android:layout_height="wrap_content"
		android:layout_weight="1"/>
		</LinearLayout>
		No newline at end of file

packages/SettingsLib/ActionButtonsPreference/res/values/styles.xml

0 → 100644

+26 −0

Original line number	Diff line number	Diff line
		<?xml version="1.0" encoding="utf-8"?>
		<!--
		Copyright (C) 2018 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.
		-->

		<resources>
		<style name="SettingsActionButton" parent="android:Widget.DeviceDefault.Button.Borderless.Colored">
		<item name="android:drawablePadding">4dp</item>
		<item name="android:drawableTint">@*android:color/btn_colored_borderless_text_material</item>
		<item name="android:layout_marginEnd">8dp</item>
		<item name="android:paddingTop">20dp</item>
		<item name="android:paddingBottom">20dp</item>
		</style>
		</resources>
		No newline at end of file

packages/SettingsLib/ActionButtonsPreference/src/com/android/settingslib/widget/ActionButtonsPreference.java

0 → 100644

+393 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2018 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.settingslib.widget;

		import android.content.Context;
		import android.content.res.Resources;
		import android.graphics.drawable.Drawable;
		import android.text.TextUtils;
		import android.util.AttributeSet;
		import android.util.Log;
		import android.view.View;
		import android.widget.Button;

		import androidx.annotation.DrawableRes;
		import androidx.annotation.StringRes;
		import androidx.preference.Preference;
		import androidx.preference.PreferenceViewHolder;

		/**
		* This preference provides a four buttons layout with Settings style.
		* It looks like below
		*
		* --------------------------------------------------
		* button1 \| button2 \| button3 \| button4 \|
		* --------------------------------------------------
		*
		* User can set title / icon / click listener for each button.
		*
		* By default, four buttons are visible.
		* However, there are two cases which button should be invisible(View.GONE).
		*
		* 1. User sets invisible for button. ex: ActionButtonPreference.setButton1Visible(false)
		* 2. User doesn't set any title or icon for button.
		*/
		public class ActionButtonsPreference extends Preference {

		private static final String TAG = "ActionButtonPreference";
		private final ButtonInfo mButton1Info = new ButtonInfo();
		private final ButtonInfo mButton2Info = new ButtonInfo();
		private final ButtonInfo mButton3Info = new ButtonInfo();
		private final ButtonInfo mButton4Info = new ButtonInfo();

		public ActionButtonsPreference(Context context, AttributeSet attrs,
		int defStyleAttr, int defStyleRes) {
		super(context, attrs, defStyleAttr, defStyleRes);
		init();
		}

		public ActionButtonsPreference(Context context, AttributeSet attrs, int defStyleAttr) {
		super(context, attrs, defStyleAttr);
		init();
		}

		public ActionButtonsPreference(Context context, AttributeSet attrs) {
		super(context, attrs);
		init();
		}

		public ActionButtonsPreference(Context context) {
		super(context);
		init();
		}

		private void init() {
		setLayoutResource(R.layout.settings_action_buttons);
		setSelectable(false);
		}

		@Override
		public void onBindViewHolder(PreferenceViewHolder holder) {
		super.onBindViewHolder(holder);
		holder.setDividerAllowedAbove(true);
		holder.setDividerAllowedBelow(true);

		mButton1Info.mButton = (Button) holder.findViewById(R.id.button1);
		mButton2Info.mButton = (Button) holder.findViewById(R.id.button2);
		mButton3Info.mButton = (Button) holder.findViewById(R.id.button3);
		mButton4Info.mButton = (Button) holder.findViewById(R.id.button4);

		mButton1Info.setUpButton();
		mButton2Info.setUpButton();
		mButton3Info.setUpButton();
		mButton4Info.setUpButton();
		}

		/**
		* Set the visibility state of button1.
		*/
		public ActionButtonsPreference setButton1Visible(boolean isVisible) {
		if (isVisible != mButton1Info.mIsVisible) {
		mButton1Info.mIsVisible = isVisible;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the text to be displayed in button1.
		*/
		public ActionButtonsPreference setButton1Text(@StringRes int textResId) {
		final String newText = getContext().getString(textResId);
		if (!TextUtils.equals(newText, mButton1Info.mText)) {
		mButton1Info.mText = newText;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the drawable to be displayed above of text in button1.
		*/
		public ActionButtonsPreference setButton1Icon(@DrawableRes int iconResId) {
		if (iconResId == 0) {
		return this;
		}

		final Drawable icon;
		try {
		icon = getContext().getDrawable(iconResId);
		mButton1Info.mIcon = icon;
		notifyChanged();
		} catch (Resources.NotFoundException exception) {
		Log.e(TAG, "Resource does not exist: " + iconResId);
		}
		return this;
		}

		/**
		* Set the enabled state of button1.
		*/
		public ActionButtonsPreference setButton1Enabled(boolean isEnabled) {
		if (isEnabled != mButton1Info.mIsEnabled) {
		mButton1Info.mIsEnabled = isEnabled;
		notifyChanged();
		}
		return this;
		}

		/**
		* Register a callback to be invoked when button1 is clicked.
		*/
		public ActionButtonsPreference setButton1OnClickListener(
		View.OnClickListener listener) {
		if (listener != mButton1Info.mListener) {
		mButton1Info.mListener = listener;
		notifyChanged();
		}
		return this;
		}

		/**
		* Set the visibility state of button2.
		*/
		public ActionButtonsPreference setButton2Visible(boolean isVisible) {
		if (isVisible != mButton2Info.mIsVisible) {
		mButton2Info.mIsVisible = isVisible;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the text to be displayed in button2.
		*/
		public ActionButtonsPreference setButton2Text(@StringRes int textResId) {
		final String newText = getContext().getString(textResId);
		if (!TextUtils.equals(newText, mButton2Info.mText)) {
		mButton2Info.mText = newText;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the drawable to be displayed above of text in button2.
		*/
		public ActionButtonsPreference setButton2Icon(@DrawableRes int iconResId) {
		if (iconResId == 0) {
		return this;
		}

		final Drawable icon;
		try {
		icon = getContext().getDrawable(iconResId);
		mButton2Info.mIcon = icon;
		notifyChanged();
		} catch (Resources.NotFoundException exception) {
		Log.e(TAG, "Resource does not exist: " + iconResId);
		}
		return this;
		}

		/**
		* Set the enabled state of button2.
		*/
		public ActionButtonsPreference setButton2Enabled(boolean isEnabled) {
		if (isEnabled != mButton2Info.mIsEnabled) {
		mButton2Info.mIsEnabled = isEnabled;
		notifyChanged();
		}
		return this;
		}

		/**
		* Register a callback to be invoked when button2 is clicked.
		*/
		public ActionButtonsPreference setButton2OnClickListener(
		View.OnClickListener listener) {
		if (listener != mButton2Info.mListener) {
		mButton2Info.mListener = listener;
		notifyChanged();
		}
		return this;
		}

		/**
		* Set the visibility state of button3.
		*/
		public ActionButtonsPreference setButton3Visible(boolean isVisible) {
		if (isVisible != mButton3Info.mIsVisible) {
		mButton3Info.mIsVisible = isVisible;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the text to be displayed in button3.
		*/
		public ActionButtonsPreference setButton3Text(@StringRes int textResId) {
		final String newText = getContext().getString(textResId);
		if (!TextUtils.equals(newText, mButton3Info.mText)) {
		mButton3Info.mText = newText;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the drawable to be displayed above of text in button3.
		*/
		public ActionButtonsPreference setButton3Icon(@DrawableRes int iconResId) {
		if (iconResId == 0) {
		return this;
		}

		final Drawable icon;
		try {
		icon = getContext().getDrawable(iconResId);
		mButton3Info.mIcon = icon;
		notifyChanged();
		} catch (Resources.NotFoundException exception) {
		Log.e(TAG, "Resource does not exist: " + iconResId);
		}
		return this;
		}

		/**
		* Set the enabled state of button3.
		*/
		public ActionButtonsPreference setButton3Enabled(boolean isEnabled) {
		if (isEnabled != mButton3Info.mIsEnabled) {
		mButton3Info.mIsEnabled = isEnabled;
		notifyChanged();
		}
		return this;
		}

		/**
		* Register a callback to be invoked when button3 is clicked.
		*/
		public ActionButtonsPreference setButton3OnClickListener(
		View.OnClickListener listener) {
		if (listener != mButton3Info.mListener) {
		mButton3Info.mListener = listener;
		notifyChanged();
		}
		return this;
		}

		/**
		* Set the visibility state of button4.
		*/
		public ActionButtonsPreference setButton4Visible(boolean isVisible) {
		if (isVisible != mButton4Info.mIsVisible) {
		mButton4Info.mIsVisible = isVisible;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the text to be displayed in button4.
		*/
		public ActionButtonsPreference setButton4Text(@StringRes int textResId) {
		final String newText = getContext().getString(textResId);
		if (!TextUtils.equals(newText, mButton4Info.mText)) {
		mButton4Info.mText = newText;
		notifyChanged();
		}
		return this;
		}

		/**
		* Sets the drawable to be displayed above of text in button4.
		*/
		public ActionButtonsPreference setButton4Icon(@DrawableRes int iconResId) {
		if (iconResId == 0) {
		return this;
		}

		final Drawable icon;
		try {
		icon = getContext().getDrawable(iconResId);
		mButton4Info.mIcon = icon;
		notifyChanged();
		} catch (Resources.NotFoundException exception) {
		Log.e(TAG, "Resource does not exist: " + iconResId);
		}
		return this;
		}

		/**
		* Set the enabled state of button4.
		*/
		public ActionButtonsPreference setButton4Enabled(boolean isEnabled) {
		if (isEnabled != mButton4Info.mIsEnabled) {
		mButton4Info.mIsEnabled = isEnabled;
		notifyChanged();
		}
		return this;
		}

		/**
		* Register a callback to be invoked when button4 is clicked.
		*/
		public ActionButtonsPreference setButton4OnClickListener(
		View.OnClickListener listener) {
		if (listener != mButton4Info.mListener) {
		mButton4Info.mListener = listener;
		notifyChanged();
		}
		return this;
		}

		static class ButtonInfo {
		private Button mButton;
		private CharSequence mText;
		private Drawable mIcon;
		private View.OnClickListener mListener;
		private boolean mIsEnabled = true;
		private boolean mIsVisible = true;

		void setUpButton() {
		mButton.setText(mText);
		mButton.setOnClickListener(mListener);
		mButton.setEnabled(mIsEnabled);
		mButton.setCompoundDrawablesWithIntrinsicBounds(
		null /* left /, mIcon / top /, null / right /, null / bottom */);

		if (shouldBeVisible()) {
		mButton.setVisibility(View.VISIBLE);
		} else {
		mButton.setVisibility(View.GONE);
		}
		}

		/**
		* By default, four buttons are visible.
		* However, there are two cases which button should be invisible.
		*
		* 1. User set invisible for this button. ex: mIsVisible = false.
		* 2. User didn't set any title or icon.
		*/
		private boolean shouldBeVisible() {
		return mIsVisible && (!TextUtils.isEmpty(mText) \|\| mIcon != null);
		}
		}
		}