IInputConnection.GetSurroundingText(Int32, Int32, Int32) 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.
Mendapatkan teks di sekitar kursor saat ini, dengan <karakter teks var>beforeLength</var> sebelum kursor (awal pilihan), <var>afterLength</var> karakter teks setelah kursor (akhir pilihan), dan semua teks yang dipilih.
[Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)]
public virtual Android.Views.InputMethods.SurroundingText? GetSurroundingText(int beforeLength, int afterLength, int flags);
[<Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)>]
abstract member GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText
override this.GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText
Parameter
- beforeLength
- Int32
Panjang teks yang diharapkan sebelum kursor.
- afterLength
- Int32
Panjang teks yang diharapkan setelah kursor.
- flags
- Int32
Menyediakan opsi tambahan yang mengontrol bagaimana teks dikembalikan. Mungkin atau 0#GET_TEXT_WITH_STYLES.
Mengembalikan
objek yang android.view.inputmethod.SurroundingText menjelaskan teks dan status pilihan di sekitarnya, atau null jika koneksi input tidak lagi valid, atau editor tidak dapat mematuhi permintaan karena alasan tertentu, atau aplikasi tidak menerapkan metode ini. Panjang teks yang dikembalikan mungkin kurang dari jumlah var<beforeLength>/var< dan >var<afterLength>/var< .>
- Atribut
Keterangan
Mendapatkan teks di sekitar kursor saat ini, dengan <karakter teks var>beforeLength</var> sebelum kursor (awal pilihan), <var>afterLength</var> karakter teks setelah kursor (akhir pilihan), dan semua teks yang dipilih. Rentangnya adalah untuk karakter java, bukan glyph yang dapat berupa beberapa karakter.
Metode ini mungkin gagal baik jika koneksi input menjadi tidak valid (seperti prosesnya crash), atau klien membutuhkan waktu terlalu lama untuk merespons dengan teks (diberi beberapa detik untuk kembali), atau protokol tidak didukung. Dalam salah satu kasus ini, 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.Spanned 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. Jika Anda menggunakan ini untuk mendapatkan teks sekitar 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.
Java dokumentasi untuk android.view.inputmethod.InputConnection.getSurroundingText(int, int, int).
Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.