# DeleteRangeGesture.Builder Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Ctors](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#inhmethods) # DeleteRangeGesture.Builder *** ** * ** *** [Kotlin](https://developer.android.com/reference/kotlin/android/view/inputmethod/DeleteRangeGesture.Builder "View this page in Kotlin")\|Java ` public static final class DeleteRangeGesture.Builder ` ` extends `[Object](https://developer.android.com/reference/java/lang/Object)` `` ` |---|-----------------------------------------------------| | [java.lang.Object](https://developer.android.com/reference/java/lang/Object) || | ↳ | android.view.inputmethod.DeleteRangeGesture.Builder |
*** ** * ** *** Builder for[DeleteRangeGesture](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture). This class is not designed to be thread-safe. ## Summary | ### Public constructors || |--------------------------------------------------------------------------------------------------------------------------|---| | ` `[Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#Builder())`() ` | | ### Public methods || |------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[DeleteRangeGesture](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture) | ` `[build](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#build())`() ` | | ` `[DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | ` `[setDeletionEndArea](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setDeletionEndArea(android.graphics.RectF))`(`[RectF](https://developer.android.com/reference/android/graphics/RectF)` endArea) ` Set rectangular single/multiline end of text deletion area intersecting with text. | | ` `[DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | ` `[setDeletionStartArea](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setDeletionStartArea(android.graphics.RectF))`(`[RectF](https://developer.android.com/reference/android/graphics/RectF)` startArea) ` Set rectangular single/multiline start of text deletion area intersecting with text. | | ` `[DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | ` `[setFallbackText](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setFallbackText(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` fallbackText) ` Set fallback text that will be committed at current cursor position if there is no applicable text beneath the area of gesture. | | ` `[DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | ` `[setGranularity](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setGranularity(int))`(int granularity) ` Define text deletion granularity. | | ### Inherited methods | |-----------------------|---| | From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | || ## Public constructors ### Builder ``` public Builder () ```

## Public methods ### build Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DeleteRangeGesture build () ```

| Returns || |-----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [DeleteRangeGesture](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture) | [DeleteRangeGesture](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture)using parameters in this[DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder). This value cannot be`null`.
| | Throws || |--------------------------------------------------------------------------------------------------------|---------------------------------------------------------| | [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if one or more positional parameters are not specified. | ### setDeletionEndArea Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DeleteRangeGesture.Builder setDeletionEndArea (RectF endArea) ``` 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[setDeletionStartArea(android.graphics.RectF)](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setDeletionStartArea(android.graphics.RectF))to the end of the last word/character in the end rectangle. ![Deletion strategy using two rectangles](https://developer.android.com/static/reference/android/images/input_method/stylus_handwriting /delete_range_gesture_rects.png)Intersection is determined using[setGranularity(int)](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setGranularity(int)). e.g.[HandwritingGesture.GRANULARITY_WORD](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_WORD)includes all the words with their width/height center included in the deletion rectangle.
| Parameters || |-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `endArea` | `RectF`:[RectF](https://developer.android.com/reference/android/graphics/RectF)(in screen coordinates) for start of deletion. This rectangle belongs to the last line where deletion should end. This value cannot be`null`.
| | Returns || |---------------------------------------------------------------------------------------------------------------------------|------------------------------------| | [DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | This value cannot be`null`.
| ### setDeletionStartArea Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DeleteRangeGesture.Builder setDeletionStartArea (RectF startArea) ``` 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[setDeletionEndArea(android.graphics.RectF)](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setDeletionEndArea(android.graphics.RectF)). ![Deletion strategy using two rectangles](https://developer.android.com/static/reference/android/images/input_method/stylus_handwriting /delete_range_gesture_rects.png) Intersection is determined using[setGranularity(int)](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder#setGranularity(int)). e.g.[HandwritingGesture.GRANULARITY_WORD](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_WORD)includes all the words with their width/height center included in the deletion rectangle.
| Parameters || |-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `startArea` | `RectF`:[RectF](https://developer.android.com/reference/android/graphics/RectF)(in screen coordinates) for start of deletion. This rectangle belongs to first line where deletion should start. This value cannot be`null`.
| | Returns || |---------------------------------------------------------------------------------------------------------------------------|------------------------------------| | [DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | This value cannot be`null`.
| ### setFallbackText Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DeleteRangeGesture.Builder setFallbackText (String fallbackText) ``` Set fallback text that will be committed at current cursor position if there is no applicable text beneath the area of gesture.
| Parameters || |----------------|-------------------------------------------------------| | `fallbackText` | `String`: text to set This value may be`null`.
| | Returns || |---------------------------------------------------------------------------------------------------------------------------|------------------------------------| | [DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | This value cannot be`null`.
| ### setGranularity Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DeleteRangeGesture.Builder setGranularity (int granularity) ``` Define text deletion granularity. Intersecting words/characters will be included in the operation.
| Parameters || |---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `granularity` | `int`:[HandwritingGesture.GRANULARITY_WORD](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_WORD)or[HandwritingGesture.GRANULARITY_CHARACTER](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_CHARACTER). Value is[HandwritingGesture.GRANULARITY_CHARACTER](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_CHARACTER), or[HandwritingGesture.GRANULARITY_WORD](https://developer.android.com/reference/android/view/inputmethod/HandwritingGesture#GRANULARITY_WORD)
| | Returns || |---------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------| | [DeleteRangeGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder) | [Builder](https://developer.android.com/reference/android/view/inputmethod/DeleteRangeGesture.Builder). This value cannot be`null`.
|