Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8c746ec6 authored by Alan Viverette's avatar Alan Viverette Committed by Automerger Merge Worker
Browse files

Merge "Fixed the reference to the compat version of the widget. Revised the... 

Merge "Fixed the reference to the compat version of the widget. Revised the class description." into tm-dev am: 96d92cfe

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/19748654



Change-Id: Iefdcf195d0a1c2268a7fa470a83d86fd7eee3a8e
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents c34bc8f7 96d92cfe

core/java/android/widget/Switch.java

+24 −14
Original line number Diff line number Diff line
@@ -61,22 +61,32 @@ import android.widget.RemoteViews.RemoteView; 
import com.android.internal.R;



/**

 * A Switch is a two-state toggle switch widget that can select between two

 * options. The user may drag the "thumb" back and forth to choose the selected option,

 * or simply tap to toggle as if it were a checkbox. The {@link #setText(CharSequence) text}

 * property controls the text displayed in the label for the switch, whereas the

 * {@link #setTextOff(CharSequence) off} and {@link #setTextOn(CharSequence) on} text

 * controls the text on the thumb. Similarly, the

 * {@link #setTextAppearance(android.content.Context, int) textAppearance} and the related

 * setTypeface() methods control the typeface and style of label text, whereas the

 * {@link #setSwitchTextAppearance(android.content.Context, int) switchTextAppearance} and

 * the related setSwitchTypeface() methods control that of the thumb.

 * A Switch is a two-state toggle widget. Users can drag the switch "thumb" back

 * and forth to select either of two options or simply tap the switch to toggle

 * between options.

 *

 * <p>{@link androidx.recyclerview.widget.RecyclerView} is a version of

 * the Switch widget which runs on devices back to API 7.</p>

 * <p>The {@link #setText(CharSequence) text} property controls

 * the text of the switch label. The {@link #setTextOn(CharSequence) textOn} and

 * {@link #setTextOff(CharSequence) textOff} properties control the text of the

 * thumb. The {@link #setTextAppearance(int) textAppearance} property and the

 * related {@link #setTypeface(android.graphics.Typeface) setTypeface()} methods

 * control the typeface and style of the switch label. The

 * {@link #setSwitchTextAppearance(android.content.Context, int)

 * switchTextAppearance} property and the related

 * {@link #setSwitchTypeface(android.graphics.Typeface) setSwitchTypeface()}

 * methods control the typeface and style of the thumb text.</p>

 *

 * <p>See the <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">Toggle Buttons</a>

 * guide.</p>

 * <p class="note"><b>Note:</b> The thumb text is displayed only if the

 * <a href="{@docRoot}reference/android/widget/Switch#attr_android:showText">

 * <code>showText</code></a> attribute is set to {@code true}. See also

 * {@link #setShowText(boolean)} and {@link #getShowText()}.</p>

 *

 * <p>{@link androidx.appcompat.widget.SwitchCompat} provides backward

 * compatibility down to Android 4.0 (API level 14).</p>

 *

 * <p>For more information, see the

 * <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">

 * Toggle Buttons</a> guide.</p>

 *

 * @attr ref android.R.styleable#Switch_textOn

 * @attr ref android.R.styleable#Switch_textOff