318 lines
11 KiB
Java
318 lines
11 KiB
Java
/*
|
|
* Copyright (C) 2006 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 android.widget;
|
|
|
|
import android.app.compat.CompatChanges;
|
|
import android.compat.annotation.ChangeId;
|
|
import android.compat.annotation.EnabledSince;
|
|
import android.content.Context;
|
|
import android.content.res.Resources;
|
|
import android.content.res.TypedArray;
|
|
import android.os.Build;
|
|
import android.text.Editable;
|
|
import android.text.Selection;
|
|
import android.text.Spannable;
|
|
import android.text.TextUtils;
|
|
import android.text.method.ArrowKeyMovementMethod;
|
|
import android.text.method.MovementMethod;
|
|
import android.text.style.SpanUtils;
|
|
import android.util.AttributeSet;
|
|
import android.view.KeyEvent;
|
|
|
|
import com.android.internal.R;
|
|
|
|
/*
|
|
* This is supposed to be a *very* thin veneer over TextView.
|
|
* Do not make any changes here that do anything that a TextView
|
|
* with a key listener and a movement method wouldn't do!
|
|
*/
|
|
|
|
/**
|
|
* A user interface element for entering and modifying text.
|
|
* When you define an edit text widget, you must specify the
|
|
* {@link android.R.styleable#TextView_inputType}
|
|
* attribute. For example, for plain text input set inputType to "text":
|
|
* <p>
|
|
* <pre>
|
|
* <EditText
|
|
* android:id="@+id/plain_text_input"
|
|
* android:layout_height="wrap_content"
|
|
* android:layout_width="match_parent"
|
|
* android:inputType="text"/></pre>
|
|
*
|
|
* Choosing the input type configures the keyboard type that is shown, acceptable characters,
|
|
* and appearance of the edit text.
|
|
* For example, if you want to accept a secret number, like a unique pin or serial number,
|
|
* you can set inputType to "numericPassword".
|
|
* An inputType of "numericPassword" results in an edit text that accepts numbers only,
|
|
* shows a numeric keyboard when focused, and masks the text that is entered for privacy.
|
|
* <p>
|
|
* See the <a href="{@docRoot}guide/topics/ui/controls/text.html">Text Fields</a>
|
|
* guide for examples of other
|
|
* {@link android.R.styleable#TextView_inputType} settings.
|
|
* </p>
|
|
* <p>You also can receive callbacks as a user changes text by
|
|
* adding a {@link android.text.TextWatcher} to the edit text.
|
|
* This is useful when you want to add auto-save functionality as changes are made,
|
|
* or validate the format of user input, for example.
|
|
* You add a text watcher using the {@link TextView#addTextChangedListener} method.
|
|
* </p>
|
|
* <p>
|
|
* This widget does not support auto-sizing text.
|
|
* <p>
|
|
* <b>XML attributes</b>
|
|
* <p>
|
|
* See {@link android.R.styleable#EditText EditText Attributes},
|
|
* {@link android.R.styleable#TextView TextView Attributes},
|
|
* {@link android.R.styleable#View View Attributes}
|
|
*
|
|
* @attr ref android.R.styleable#EditText_enableTextStylingShortcuts
|
|
*/
|
|
public class EditText extends TextView {
|
|
|
|
// True if the style shortcut is enabled.
|
|
private boolean mStyleShortcutsEnabled = false;
|
|
|
|
private static final int ID_BOLD = android.R.id.bold;
|
|
private static final int ID_ITALIC = android.R.id.italic;
|
|
private static final int ID_UNDERLINE = android.R.id.underline;
|
|
|
|
/** @hide */
|
|
@ChangeId
|
|
@EnabledSince(targetSdkVersion = Build.VERSION_CODES.VANILLA_ICE_CREAM)
|
|
public static final long LINE_HEIGHT_FOR_LOCALE = 303326708L;
|
|
|
|
public EditText(Context context) {
|
|
this(context, null);
|
|
}
|
|
|
|
public EditText(Context context, AttributeSet attrs) {
|
|
this(context, attrs, com.android.internal.R.attr.editTextStyle);
|
|
}
|
|
|
|
public EditText(Context context, AttributeSet attrs, int defStyleAttr) {
|
|
this(context, attrs, defStyleAttr, 0);
|
|
}
|
|
|
|
public EditText(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
|
|
super(context, attrs, defStyleAttr, defStyleRes);
|
|
|
|
final Resources.Theme theme = context.getTheme();
|
|
final TypedArray a = theme.obtainStyledAttributes(attrs,
|
|
com.android.internal.R.styleable.EditText, defStyleAttr, defStyleRes);
|
|
|
|
try {
|
|
final int n = a.getIndexCount();
|
|
for (int i = 0; i < n; ++i) {
|
|
int attr = a.getIndex(i);
|
|
switch (attr) {
|
|
case com.android.internal.R.styleable.EditText_enableTextStylingShortcuts:
|
|
mStyleShortcutsEnabled = a.getBoolean(attr, false);
|
|
break;
|
|
}
|
|
}
|
|
} finally {
|
|
a.recycle();
|
|
}
|
|
|
|
boolean hasUseLocalePreferredLineHeightForMinimumInt = false;
|
|
boolean useLocalePreferredLineHeightForMinimumInt = false;
|
|
TypedArray tvArray = theme.obtainStyledAttributes(attrs,
|
|
com.android.internal.R.styleable.TextView, defStyleAttr, defStyleRes);
|
|
try {
|
|
hasUseLocalePreferredLineHeightForMinimumInt =
|
|
tvArray.hasValue(R.styleable.TextView_useLocalePreferredLineHeightForMinimum);
|
|
if (hasUseLocalePreferredLineHeightForMinimumInt) {
|
|
useLocalePreferredLineHeightForMinimumInt = tvArray.getBoolean(
|
|
R.styleable.TextView_useLocalePreferredLineHeightForMinimum, false);
|
|
}
|
|
} finally {
|
|
tvArray.recycle();
|
|
}
|
|
if (!hasUseLocalePreferredLineHeightForMinimumInt) {
|
|
useLocalePreferredLineHeightForMinimumInt =
|
|
CompatChanges.isChangeEnabled(LINE_HEIGHT_FOR_LOCALE);
|
|
}
|
|
setLocalePreferredLineHeightForMinimumUsed(useLocalePreferredLineHeightForMinimumInt);
|
|
}
|
|
|
|
@Override
|
|
public boolean getFreezesText() {
|
|
return true;
|
|
}
|
|
|
|
@Override
|
|
protected boolean getDefaultEditable() {
|
|
return true;
|
|
}
|
|
|
|
@Override
|
|
protected MovementMethod getDefaultMovementMethod() {
|
|
return ArrowKeyMovementMethod.getInstance();
|
|
}
|
|
|
|
@Override
|
|
public Editable getText() {
|
|
CharSequence text = super.getText();
|
|
// This can only happen during construction.
|
|
if (text == null) {
|
|
return null;
|
|
}
|
|
if (text instanceof Editable) {
|
|
return (Editable) text;
|
|
}
|
|
super.setText(text, BufferType.EDITABLE);
|
|
return (Editable) super.getText();
|
|
}
|
|
|
|
@Override
|
|
public void setText(CharSequence text, BufferType type) {
|
|
super.setText(text, BufferType.EDITABLE);
|
|
}
|
|
|
|
/**
|
|
* Convenience for {@link Selection#setSelection(Spannable, int, int)}.
|
|
*/
|
|
public void setSelection(int start, int stop) {
|
|
Selection.setSelection(getText(), start, stop);
|
|
}
|
|
|
|
/**
|
|
* Convenience for {@link Selection#setSelection(Spannable, int)}.
|
|
*/
|
|
public void setSelection(int index) {
|
|
Selection.setSelection(getText(), index);
|
|
}
|
|
|
|
/**
|
|
* Convenience for {@link Selection#selectAll}.
|
|
*/
|
|
public void selectAll() {
|
|
Selection.selectAll(getText());
|
|
}
|
|
|
|
/**
|
|
* Convenience for {@link Selection#extendSelection}.
|
|
*/
|
|
public void extendSelection(int index) {
|
|
Selection.extendSelection(getText(), index);
|
|
}
|
|
|
|
/**
|
|
* Causes words in the text that are longer than the view's width to be ellipsized instead of
|
|
* broken in the middle. {@link TextUtils.TruncateAt#MARQUEE
|
|
* TextUtils.TruncateAt#MARQUEE} is not supported.
|
|
*
|
|
* @param ellipsis Type of ellipsis to be applied.
|
|
* @throws IllegalArgumentException When the value of <code>ellipsis</code> parameter is
|
|
* {@link TextUtils.TruncateAt#MARQUEE}.
|
|
* @see TextView#setEllipsize(TextUtils.TruncateAt)
|
|
*/
|
|
@Override
|
|
public void setEllipsize(TextUtils.TruncateAt ellipsis) {
|
|
if (ellipsis == TextUtils.TruncateAt.MARQUEE) {
|
|
throw new IllegalArgumentException("EditText cannot use the ellipsize mode "
|
|
+ "TextUtils.TruncateAt.MARQUEE");
|
|
}
|
|
super.setEllipsize(ellipsis);
|
|
}
|
|
|
|
@Override
|
|
public CharSequence getAccessibilityClassName() {
|
|
return EditText.class.getName();
|
|
}
|
|
|
|
/** @hide */
|
|
@Override
|
|
protected boolean supportsAutoSizeText() {
|
|
return false;
|
|
}
|
|
|
|
@Override
|
|
public boolean onKeyShortcut(int keyCode, KeyEvent event) {
|
|
if (event.hasModifiers(KeyEvent.META_CTRL_ON)) {
|
|
// Handle Ctrl-only shortcuts.
|
|
switch (keyCode) {
|
|
case KeyEvent.KEYCODE_B:
|
|
if (mStyleShortcutsEnabled && hasSelection()) {
|
|
return onTextContextMenuItem(ID_BOLD);
|
|
}
|
|
break;
|
|
case KeyEvent.KEYCODE_I:
|
|
if (mStyleShortcutsEnabled && hasSelection()) {
|
|
return onTextContextMenuItem(ID_ITALIC);
|
|
}
|
|
break;
|
|
case KeyEvent.KEYCODE_U:
|
|
if (mStyleShortcutsEnabled && hasSelection()) {
|
|
return onTextContextMenuItem(ID_UNDERLINE);
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
return super.onKeyShortcut(keyCode, event);
|
|
}
|
|
|
|
@Override
|
|
public boolean onTextContextMenuItem(int id) {
|
|
// TODO: Move to switch-case once the resource ID is finalized.
|
|
if (id == ID_BOLD || id == ID_ITALIC || id == ID_UNDERLINE) {
|
|
return performStylingAction(id);
|
|
}
|
|
return super.onTextContextMenuItem(id);
|
|
}
|
|
|
|
private boolean performStylingAction(int actionId) {
|
|
final int selectionStart = getSelectionStart();
|
|
final int selectionEnd = getSelectionEnd();
|
|
if (selectionStart < 0 || selectionEnd < 0) {
|
|
return false; // There is no selection.
|
|
}
|
|
int min = Math.min(selectionStart, selectionEnd);
|
|
int max = Math.max(selectionStart, selectionEnd);
|
|
|
|
|
|
Spannable spannable = getText();
|
|
if (actionId == ID_BOLD) {
|
|
return SpanUtils.toggleBold(spannable, min, max);
|
|
} else if (actionId == ID_ITALIC) {
|
|
return SpanUtils.toggleItalic(spannable, min, max);
|
|
} else if (actionId == ID_UNDERLINE) {
|
|
return SpanUtils.toggleUnderline(spannable, min, max);
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Enables styls shortcuts, e.g. Ctrl+B for making text bold.
|
|
*
|
|
* @param enabled true for enabled, false for disabled.
|
|
*/
|
|
public void setStyleShortcutsEnabled(boolean enabled) {
|
|
mStyleShortcutsEnabled = enabled;
|
|
}
|
|
|
|
/**
|
|
* Return true if style shortcut is enabled, otherwise returns false.
|
|
* @return true if style shortcut is enabled, otherwise returns false.
|
|
*/
|
|
public boolean isStyleShortcutEnabled() {
|
|
return mStyleShortcutsEnabled;
|
|
}
|
|
}
|