IInputConnection.GetTextBeforeCursorFormatted(Int32, GetTextFlags) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Dapatkan <karakter teks var>n</var> sebelum posisi kursor saat ini.
[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.ICharSequenceParameter
- n
- Int32
Panjang teks yang diharapkan. Ini harus non-negatif.
- flags
- GetTextFlags
Menyediakan opsi tambahan yang mengontrol bagaimana teks dikembalikan. Mungkin atau 0 #GET_TEXT_WITH_STYLES.
Mengembalikan
teks sebelum posisi kursor; panjang teks yang dikembalikan mungkin kurang dari <var>n</var>.
- Atribut
Keterangan
Dapatkan <karakter teks var>n</var> sebelum posisi kursor saat ini.
Metode ini mungkin gagal baik jika koneksi input menjadi tidak valid (seperti prosesnya crash) atau editor membutuhkan waktu terlalu lama untuk merespons dengan teks (diberi beberapa detik untuk kembali). Dalam kedua kasus, null dikembalikan. Metode ini tidak memengaruhi teks di editor dengan cara apa pun, juga tidak memengaruhi rentang pemilihan atau pembuatan.
Jika #GET_TEXT_WITH_STYLES disediakan sebagai bendera, editor harus mengembalikan dengan semua rentang yang android.text.SpannableString diatur pada teks.
<penulis IME yang kuat>:</kuat> , harap pertimbangkan ini akan memicu perjalanan pulang pergi IPC yang akan memakan waktu. Asumsikan metode ini menghabiskan banyak waktu. Selain itu, perlu diingat bahwa Editor dapat memilih untuk mengembalikan lebih sedikit karakter daripada yang diminta bahkan jika tersedia karena alasan performa. Jika Anda menggunakan ini untuk mendapatkan teks awal di sekitar kursor, Anda dapat mempertimbangkan untuk menggunakan EditorInfo#getInitialTextBeforeCursor(int, int), EditorInfo#getInitialSelectedText(int), dan EditorInfo#getInitialTextAfterCursor(int, int) untuk mencegah biaya IPC.
<penulis Editor yang kuat>:</kuat> harap berhati-hati terhadap kondisi balapan dalam menerapkan panggilan ini. IME dapat membuat perubahan pada teks dan langsung menggunakan metode ini; Anda perlu memastikan nilai yang dikembalikan konsisten dengan hasil pengeditan terbaru. Selain itu, Anda dapat mengembalikan kurang dari karakter n jika performa menentukan demikian, tetapi perlu diingat IMEs mengandalkan ini untuk banyak fungsi: Anda tidak boleh, misalnya, membatasi nilai yang dikembalikan ke baris saat ini, dan secara khusus tidak mengembalikan 0 karakter kecuali kursor benar-benar di awal teks.
Dokumentasi Java untuk android.view.inputmethod.InputConnection.getTextBeforeCursor(int, int).
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.