# InsertGesture.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/InsertGesture.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#inhmethods)  

# InsertGesture.Builder

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/view/inputmethod/InsertGesture.Builder "View this page in Kotlin")\|Java

`
public
static
final

class
InsertGesture.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.InsertGesture.Builder |

<br />

*** ** * ** ***

Builder for[InsertGesture](https://developer.android.com/reference/android/view/inputmethod/InsertGesture). This class is not designed to be thread-safe.

## Summary

|                                                ### Public constructors                                                 ||
|---------------------------------------------------------------------------------------------------------------------|---|
| ` `[Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#Builder())`() ` |

|                                                                                                                                                                                                                                                                                             ### Public methods                                                                                                                                                                                                                                                                                             ||
|--------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[InsertGesture](https://developer.android.com/reference/android/view/inputmethod/InsertGesture)                 | ` `[build](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#build())`() `                                                                                                                                                                                                                                                                                                                                                                        |
| ` `[InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | ` `[setFallbackText](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.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.                                                                                                                   |
| ` `[InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | ` `[setInsertionPoint](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setInsertionPoint(android.graphics.PointF))`(`[PointF](https://developer.android.com/reference/android/graphics/PointF)` point) ` Sets the insertion point (in screen coordinates) where[setTextToInsert(java.lang.String)](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setTextToInsert(java.lang.String))should be inserted. |
| ` `[InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | ` `[setTextToInsert](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setTextToInsert(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` text) ` Set the text that will be inserted at[setInsertionPoint(android.graphics.PointF)](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setInsertionPoint(android.graphics.PointF)).                                     |

| ### 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 ()
```

<br />

<br />

## Public methods

### build

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

```
public InsertGesture build ()
```

<br />

<br />

|                                                                                                                                                                                   Returns                                                                                                                                                                                   ||
|-------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [InsertGesture](https://developer.android.com/reference/android/view/inputmethod/InsertGesture) | [InsertGesture](https://developer.android.com/reference/android/view/inputmethod/InsertGesture)using parameters in this[InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder). This value cannot be`null`. <br /> |

|                                                                             Throws                                                                              ||
|--------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if one or more positional parameters are not specified. |

### setFallbackText

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

```
public InsertGesture.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.

<br />

|                  Parameters                  ||
|----------------|------------------------------|
| `fallbackText` | `String`: text to set <br /> |

|                                                                       Returns                                                                       ||
|-----------------------------------------------------------------------------------------------------------------|------------------------------------|
| [InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | This value cannot be`null`. <br /> |

### setInsertionPoint

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

```
public InsertGesture.Builder setInsertionPoint (PointF point)
```

Sets the insertion point (in screen coordinates) where[setTextToInsert(java.lang.String)](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setTextToInsert(java.lang.String))should be inserted.

<br />

|                      Parameters                       ||
|---------|----------------------------------------------|
| `point` | `PointF`: This value cannot be`null`. <br /> |

|                                                                       Returns                                                                       ||
|-----------------------------------------------------------------------------------------------------------------|------------------------------------|
| [InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | This value cannot be`null`. <br /> |

### setTextToInsert

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

```
public InsertGesture.Builder setTextToInsert (String text)
```

Set the text that will be inserted at[setInsertionPoint(android.graphics.PointF)](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder#setInsertionPoint(android.graphics.PointF)). When set with an empty string, cursor will be moved to[InsertGesture.getInsertionPoint()](https://developer.android.com/reference/android/view/inputmethod/InsertGesture#getInsertionPoint())and no text would be inserted.

<br />

|                      Parameters                      ||
|--------|----------------------------------------------|
| `text` | `String`: This value cannot be`null`. <br /> |

|                                                                       Returns                                                                       ||
|-----------------------------------------------------------------------------------------------------------------|------------------------------------|
| [InsertGesture.Builder](https://developer.android.com/reference/android/view/inputmethod/InsertGesture.Builder) | This value cannot be`null`. <br /> |