Condividi tramite


IInputConnection.GetTextBeforeCursorFormatted(Int32, GetTextFlags) Metodo

Definizione

Ottiene <i caratteri var>n</var> del testo prima della posizione corrente del cursore.

[Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Lang.ICharSequence? GetTextBeforeCursorFormatted (int n, Android.Views.InputMethods.GetTextFlags flags);
[<Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member GetTextBeforeCursorFormatted : int * Android.Views.InputMethods.GetTextFlags -> Java.Lang.ICharSequence

Parametri

n
Int32

Lunghezza prevista del testo. Questo deve essere non negativo.

flags
GetTextFlags

Fornisce opzioni aggiuntive che controllano la modalità di restituzione del testo. Può essere 0 o #GET_TEXT_WITH_STYLES.

Restituisce

il testo prima della posizione del cursore; La lunghezza del testo restituito potrebbe essere minore di <var>n</var>.

Attributi

Commenti

Ottiene <i caratteri var>n</var> del testo prima della posizione corrente del cursore.

Questo metodo potrebbe avere esito negativo se la connessione di input non è valida ,ad esempio l'arresto anomalo del processo, oppure l'editor richiede troppo tempo per rispondere con il testo (viene dato un paio di secondi per restituire). In entrambi i casi, viene restituito null. Questo metodo non influisce in alcun modo sul testo nell'editor, né influisce sulla selezione o sulla composizione degli intervalli.

Se #GET_TEXT_WITH_STYLES viene specificato come flag, l'editor deve restituire un oggetto android.text.SpannableString con tutti gli intervalli impostati sul testo.

<forti>autori IME:< /forte> si prega di considerare che questo attiverà un round trip IPC che richiederà del tempo. Si supponga che questo metodo consuma molto tempo. Tenere inoltre presente che l'editor può scegliere di restituire meno caratteri rispetto a quelli richiesti anche se sono disponibili per motivi di prestazioni. Se si usa questa opzione per ottenere il testo iniziale intorno al cursore, è possibile prendere in considerazione l'uso EditorInfo#getInitialTextBeforeCursor(int, int)di , EditorInfo#getInitialSelectedText(int)e EditorInfo#getInitialTextAfterCursor(int, int) per evitare i costi IPC.

<forti>autori editor:</forte> si prega di prestare attenzione alle condizioni di gara nell'implementazione di questa chiamata. Un IME può apportare una modifica al testo e usare subito questo metodo; è necessario assicurarsi che il valore restituito sia coerente con il risultato delle modifiche più recenti. Inoltre, è possibile restituire meno di n caratteri se le prestazioni determinano in questo modo, ma tenere presente che gli IMEs si basano su questa funzione per molte funzioni: non è consigliabile, ad esempio, limitare il valore restituito alla riga corrente e in particolare non restituire 0 caratteri a meno che il cursore non sia effettivamente all'inizio del testo.

Documentazione java per android.view.inputmethod.InputConnection.getTextBeforeCursor(int, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a