InputMethodManager.SetExplicitlyEnabledInputMethodSubtypes Metodo

Definizione

Spazio dei nomi:

Android.Views.InputMethods

Assembly:

Mono.Android.dll

Aggiorna l'elenco di abilitato in modo esplicito InputMethodSubtype per un determinato IME di proprietà del processo chiamante.

[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

Parametri

imiId

String

ID IME. L'IME specificato e il processo chiamante devono appartenere allo stesso pacchetto. In caso contrario SecurityException , verrà generata.

subtypeHashCodes

Int32[]

Matrici di InputMethodSubtype#hashCode() da abilitare in modo esplicito. Le voci trovate nell'IME specificato verranno ignorate automaticamente. Passare una matrice vuota per reimpostare lo stato sul valore predefinito.

Attributi

RegisterAttribute

Commenti

Aggiorna l'elenco di abilitato in modo esplicito InputMethodSubtype per un determinato IME di proprietà del processo chiamante.

Per impostazione predefinita, ogni IME non ha abilitato in modo esplicito InputMethodSubtype. In questo stato il sistema deciderà cosa InputMethodSubtype deve essere abilitato usando le informazioni disponibili in fase di esecuzione come impostazioni della lingua per utente. Gli utenti possono tuttavia selezionare manualmente una o più InputMethodSubtype attività da abilitare in un'attività visualizzata da #showInputMethodAndSubtypeEnabler(String). Tale modifica manuale viene archiviata in in Settings.Secure#ENABLED_INPUT_METHODS modo che la modifica possa persistere tra i riavvii. Settings.Secure#ENABLED_INPUT_METHODS archivia InputMethodSubtype#hashCode() come identificatore di InputMethodSubtype per motivi cronologici.

Questa API offre agli sviluppatori IME un modo sicuro e gestito per modificare gli elementi a cui InputMethodSubtype viene fatto riferimento per Settings.Secure#ENABLED_INPUT_METHODS il proprio IME. Un caso d'uso è quando gli sviluppatori IME vogliono usare la propria attività per consentire agli utenti di selezionare InputMethodSubtype. Un altro caso d'uso è che gli sviluppatori IME risolvano qualsiasi valore non aggiornato e/o non valido archiviato in Settings.Secure#ENABLED_INPUT_METHODS senza disturbare gli utenti. Il passaggio di un vuoto subtypeHashCodes è garantito per reimpostare lo stato su predefinito.

<h3>Per controllare il valore restituito di InputMethodSubtype#hashCode()</h3>

android.R.attr#subtypeId e android.view.inputmethod.InputMethodSubtype.InputMethodSubtypeBuilder#setSubtypeId(int) sono disponibili per gli sviluppatori IME per controllare il valore restituito di InputMethodSubtype#hashCode(). Tenere presente che -1 non è un valore valido per InputMethodSubtype#hashCode() motivi cronologici.

<h3>Nota per il supporto< per l'avvio diretto/h3>

Anche se gli sviluppatori IME possono chiamare questa API anche prima android.os.UserManager#isUserUnlocked() di diventare true, tale modifica è volatile, quindi rimane effettiva solo fino a android.os.UserManager#isUserUnlocked() quando non diventa true o il dispositivo viene riavviato. Per rendere persistente la modifica gli sviluppatori IME devono chiamare nuovamente questa API dopo aver ricevuto Intent#ACTION_USER_UNLOCKED.

per android.view.inputmethod.InputMethodManager.setExplicitlyEnabledInputMethodSubtypes(java.lang.String, int[]).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.