244 lines
8.8 KiB
Java
244 lines
8.8 KiB
Java
/*
|
|
* Copyright (C) 2022 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.view.inputmethod;
|
|
|
|
import android.annotation.NonNull;
|
|
import android.annotation.Nullable;
|
|
import android.annotation.SuppressLint;
|
|
import android.graphics.RectF;
|
|
import android.os.Parcel;
|
|
import android.os.Parcelable;
|
|
import android.widget.TextView;
|
|
|
|
import java.util.Objects;
|
|
|
|
/**
|
|
* A subclass of {@link HandwritingGesture} for deleting a range of text by defining start and end
|
|
* rectangles. This can be useful when the range cannot be defined with a single rectangle.
|
|
* This class holds the information required for deletion of text in
|
|
* toolkit widgets like {@link TextView}.
|
|
* <p>Note: this deletes text within a range <em>between</em> two given areas. To delete all text
|
|
* <em>within</em> a single area, use {@link DeleteGesture}.</p>
|
|
*/
|
|
public final class DeleteRangeGesture extends PreviewableHandwritingGesture implements Parcelable {
|
|
|
|
private @Granularity int mGranularity;
|
|
private RectF mStartArea;
|
|
private RectF mEndArea;
|
|
|
|
private DeleteRangeGesture(
|
|
int granularity, RectF startArea, RectF endArea, String fallbackText) {
|
|
mType = GESTURE_TYPE_DELETE_RANGE;
|
|
mStartArea = startArea;
|
|
mEndArea = endArea;
|
|
mGranularity = granularity;
|
|
mFallbackText = fallbackText;
|
|
}
|
|
|
|
private DeleteRangeGesture(@NonNull Parcel source) {
|
|
mType = GESTURE_TYPE_DELETE_RANGE;
|
|
mFallbackText = source.readString8();
|
|
mGranularity = source.readInt();
|
|
mStartArea = source.readTypedObject(RectF.CREATOR);
|
|
mEndArea = source.readTypedObject(RectF.CREATOR);
|
|
}
|
|
|
|
/**
|
|
* Returns Granular level on which text should be operated.
|
|
* @see #GRANULARITY_CHARACTER
|
|
* @see #GRANULARITY_WORD
|
|
*/
|
|
@Granularity
|
|
public int getGranularity() {
|
|
return mGranularity;
|
|
}
|
|
|
|
/**
|
|
* Returns the Deletion start area {@link RectF} in screen coordinates.
|
|
*
|
|
* Getter for deletion area set with {@link Builder#setDeletionStartArea(RectF)}.
|
|
*/
|
|
@NonNull
|
|
public RectF getDeletionStartArea() {
|
|
return mStartArea;
|
|
}
|
|
|
|
/**
|
|
* Returns the Deletion end area {@link RectF} in screen coordinates.
|
|
*
|
|
* Getter for deletion area set with {@link Builder#setDeletionEndArea(RectF)}.
|
|
*/
|
|
@NonNull
|
|
public RectF getDeletionEndArea() {
|
|
return mEndArea;
|
|
}
|
|
|
|
/**
|
|
* Builder for {@link DeleteRangeGesture}. This class is not designed to be thread-safe.
|
|
*/
|
|
public static final class Builder {
|
|
private int mGranularity;
|
|
private RectF mStartArea;
|
|
private RectF mEndArea;
|
|
private String mFallbackText;
|
|
|
|
/**
|
|
* Define text deletion granularity. Intersecting words/characters will be
|
|
* included in the operation.
|
|
* @param granularity {@link HandwritingGesture#GRANULARITY_WORD} or
|
|
* {@link HandwritingGesture#GRANULARITY_CHARACTER}.
|
|
* @return {@link Builder}.
|
|
*/
|
|
@NonNull
|
|
@SuppressLint("MissingGetterMatchingBuilder")
|
|
public Builder setGranularity(@Granularity int granularity) {
|
|
mGranularity = granularity;
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Set rectangular single/multiline start of text deletion area intersecting with text.
|
|
*
|
|
* The resulting deletion is performed from the start of first word/character in the start
|
|
* rectangle to the end of the last word/character in the end rectangle
|
|
* {@link #setDeletionEndArea(RectF)}.
|
|
* <br/>
|
|
* <img src="{@docRoot}reference/android/images/input_method/stylus_handwriting
|
|
* /delete_range_gesture_rects.png"
|
|
* height="300" alt="Deletion strategy using two rectangles"/>
|
|
* <br/>
|
|
*
|
|
* Intersection is determined using
|
|
* {@link #setGranularity(int)}. e.g. {@link HandwritingGesture#GRANULARITY_WORD} includes
|
|
* all the words with their width/height center included in the deletion rectangle.
|
|
* @param startArea {@link RectF} (in screen coordinates) for start of deletion. This
|
|
* rectangle belongs to first line where deletion should start.
|
|
*/
|
|
@NonNull
|
|
@SuppressLint("MissingGetterMatchingBuilder")
|
|
public Builder setDeletionStartArea(@NonNull RectF startArea) {
|
|
mStartArea = startArea;
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Set rectangular single/multiline end of text deletion area intersecting with text.
|
|
*
|
|
* The resulting deletion is performed from the start of first word/character in the start
|
|
* rectangle {@link #setDeletionStartArea(RectF)} to the end of the last word/character in
|
|
* the end rectangle.
|
|
* <br/>
|
|
* <img src="{@docRoot}reference/android/images/input_method/stylus_handwriting
|
|
* /delete_range_gesture_rects.png"
|
|
* height="300" alt="Deletion strategy using two rectangles"/>
|
|
*
|
|
* Intersection is determined using
|
|
* {@link #setGranularity(int)}. e.g. {@link HandwritingGesture#GRANULARITY_WORD} includes
|
|
* all the words with their width/height center included in the deletion rectangle.
|
|
* @param endArea {@link RectF} (in screen coordinates) for start of deletion. This
|
|
* rectangle belongs to the last line where deletion should end.
|
|
*/
|
|
@NonNull
|
|
@SuppressLint("MissingGetterMatchingBuilder")
|
|
public Builder setDeletionEndArea(@NonNull RectF endArea) {
|
|
mEndArea = endArea;
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Set fallback text that will be committed at current cursor position if there is no
|
|
* applicable text beneath the area of gesture.
|
|
* @param fallbackText text to set
|
|
*/
|
|
@NonNull
|
|
public Builder setFallbackText(@Nullable String fallbackText) {
|
|
mFallbackText = fallbackText;
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* @return {@link DeleteRangeGesture} using parameters in this
|
|
* {@link DeleteRangeGesture.Builder}.
|
|
* @throws IllegalArgumentException if one or more positional parameters are not specified.
|
|
*/
|
|
@NonNull
|
|
public DeleteRangeGesture build() {
|
|
if (mStartArea == null || mStartArea.isEmpty() || mEndArea == null
|
|
|| mEndArea.isEmpty()) {
|
|
throw new IllegalArgumentException("Deletion area must be set.");
|
|
}
|
|
if (mGranularity <= GRANULARITY_UNDEFINED) {
|
|
throw new IllegalArgumentException("Deletion granularity must be set.");
|
|
}
|
|
return new DeleteRangeGesture(mGranularity, mStartArea, mEndArea, mFallbackText);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Used to make this class parcelable.
|
|
*/
|
|
@NonNull
|
|
public static final Creator<DeleteRangeGesture> CREATOR =
|
|
new Creator<DeleteRangeGesture>() {
|
|
@Override
|
|
public DeleteRangeGesture createFromParcel(Parcel source) {
|
|
return new DeleteRangeGesture(source);
|
|
}
|
|
|
|
@Override
|
|
public DeleteRangeGesture[] newArray(int size) {
|
|
return new DeleteRangeGesture[size];
|
|
}
|
|
};
|
|
|
|
@Override
|
|
public int hashCode() {
|
|
return Objects.hash(mGranularity, mStartArea, mEndArea, mFallbackText);
|
|
}
|
|
|
|
@Override
|
|
public boolean equals(Object o) {
|
|
if (!(o instanceof DeleteRangeGesture)) return false;
|
|
|
|
DeleteRangeGesture that = (DeleteRangeGesture) o;
|
|
|
|
if (mGranularity != that.mGranularity) return false;
|
|
if (!Objects.equals(mFallbackText, that.mFallbackText)) return false;
|
|
if (!Objects.equals(mStartArea, that.mStartArea)) return false;
|
|
return Objects.equals(mEndArea, that.mEndArea);
|
|
}
|
|
|
|
@Override
|
|
public int describeContents() {
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* Used to package this object into a {@link Parcel}.
|
|
*
|
|
* @param dest The {@link Parcel} to be written.
|
|
* @param flags The flags used for parceling.
|
|
*/
|
|
@Override
|
|
public void writeToParcel(@NonNull Parcel dest, int flags) {
|
|
dest.writeString8(mFallbackText);
|
|
dest.writeInt(mGranularity);
|
|
dest.writeTypedObject(mStartArea, flags);
|
|
dest.writeTypedObject(mEndArea, flags);
|
|
}
|
|
}
|