InputMethodManager.SetExplicitlyEnabledInputMethodSubtypes Metode

Definisi

Ruang nama:: Android.Views.InputMethods

Rakitan:: Mono.Android.dll

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.

Memperbarui daftar yang diaktifkan InputMethodSubtype secara eksplisit untuk IME tertentu yang dimiliki oleh proses panggilan.

[Android.Runtime.Register("setExplicitlyEnabledInputMethodSubtypes", "(Ljava/lang/String;[I)V", "", ApiSince=34)]
public void SetExplicitlyEnabledInputMethodSubtypes(string imiId, int[] subtypeHashCodes);

[<Android.Runtime.Register("setExplicitlyEnabledInputMethodSubtypes", "(Ljava/lang/String;[I)V", "", ApiSince=34)>]
member this.SetExplicitlyEnabledInputMethodSubtypes : string * int[] -> unit

Parameter

imiId: String

ID IME. IME yang ditentukan dan proses panggilan harus termasuk dalam paket yang sama. Jika tidak SecurityException , akan dilemparkan.

subtypeHashCodes: Int32[]

Array InputMethodSubtype#hashCode() yang akan diaktifkan secara eksplisit. Entri yang ditemukan dalam IME yang ditentukan akan diabaikan secara diam-diam. Teruskan array kosong untuk mengatur ulang status ke default.

Atribut: RegisterAttribute

Keterangan

Memperbarui daftar yang diaktifkan InputMethodSubtype secara eksplisit untuk IME tertentu yang dimiliki oleh proses panggilan.

Secara default setiap IME tidak mengaktifkan secara InputMethodSubtypeeksplisit . Dalam status ini, sistem akan memutuskan apa yang harus diaktifkan dengan menggunakan informasi yang InputMethodSubtype tersedia pada runtime sebagai pengaturan bahasa per pengguna. Namun, pengguna dapat mengambil satu atau beberapa InputMethodSubtype secara manual untuk diaktifkan pada Aktivitas yang ditunjukkan oleh #showInputMethodAndSubtypeEnabler(String). Perubahan manual seperti itu disimpan Settings.Secure#ENABLED_INPUT_METHODS di sehingga perubahan dapat bertahan di seluruh reboot. Settings.Secure#ENABLED_INPUT_METHODS InputMethodSubtype#hashCode() disimpan sebagai pengidentifikasi karena InputMethodSubtype alasan historis.

API ini menyediakan cara yang aman dan terkelola bagi pengembang IME untuk memodifikasi apa yang InputMethodSubtype dirujuk untuk Settings.Secure#ENABLED_INPUT_METHODS IME mereka sendiri. Salah satu kasus penggunaan adalah ketika pengembang IME ingin menggunakan Aktivitas mereka sendiri bagi pengguna untuk mengambil InputMethodSubtype. Kasus penggunaan lain adalah bagi pengembang IME untuk memperbaiki nilai basi dan/atau tidak valid yang disimpan di Settings.Secure#ENABLED_INPUT_METHODS tanpa mengganggu pengguna. Meneruskan kosong subtypeHashCodes dijamin untuk mengatur ulang status ke default.

<h3>Untuk mengontrol nilai InputMethodSubtype#hashCode()<pengembalian /h3>

android.R.attr#subtypeIddan android.view.inputmethod.InputMethodSubtype.InputMethodSubtypeBuilder#setSubtypeId(int) tersedia bagi pengembang IME untuk mengontrol nilai pengembalian .InputMethodSubtype#hashCode() Waspadalah bahwa -1 bukan nilai yang valid karena InputMethodSubtype#hashCode() alasan historis.

<h3>Catatan untuk dukungan< Boot Langsung/h3>

Sementara pengembang IME dapat memanggil API ini bahkan sebelum android.os.UserManager#isUserUnlocked() menjadi true, perubahan seperti itu volatil sehingga tetap efektif hanya sampai android.os.UserManager#isUserUnlocked() menjadi true atau perangkat di-boot ulang. Untuk membuat pengembang IME persisten perubahan perlu memanggil API ini lagi setelah menerima Intent#ACTION_USER_UNLOCKED.

Java dokumentasi untuk android.view.inputmethod.InputMethodManager.setExplicitlyEnabledInputMethodSubtypes(java.lang.String, 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.

Berlaku untuk