IInputConnection.GetTextBeforeCursorFormatted(Int32, GetTextFlags) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.