InputMethodManager.SetExplicitlyEnabledInputMethodSubtypes Methode

Definition

Namespace:: Android.Views.InputMethods

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Aktualisiert die Liste der explizit für InputMethodSubtype einen bestimmten IME aktivierten IME im Besitz des aufrufenden Prozesses.

[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

IME-ID. Der angegebene IME und der aufrufende Prozess müssen zum gleichen Paket gehören. Andernfalls SecurityException wird dies ausgelöst.

subtypeHashCodes: Int32[]

Ein Arrays, das InputMethodSubtype#hashCode() explizit aktiviert werden soll. Einträge, die im angegebenen IME gefunden werden, werden automatisch ignoriert. Übergeben Sie ein leeres Array, um den Status auf den Standardwert zurückzusetzen.

Attribute: RegisterAttribute

Hinweise

Aktualisiert die Liste der explizit für InputMethodSubtype einen bestimmten IME aktivierten IME im Besitz des aufrufenden Prozesses.

Standardmäßig ist jeder IME nicht explizit aktiviert InputMethodSubtype. In diesem Zustand entscheidet das System, was InputMethodSubtype aktiviert werden soll, indem Informationen verwendet werden, die zur Laufzeit als Spracheinstellungen pro Benutzer verfügbar sind. Benutzer können jedoch manuell eine oder InputMethodSubtype mehrere aktivieren, um für eine von #showInputMethodAndSubtypeEnabler(String)ihnen angezeigte Aktivität aktiviert zu werden. Eine solche manuelle Änderung wird gespeichert Settings.Secure#ENABLED_INPUT_METHODS , sodass die Änderung über Neustarts hinweg beibehalten werden kann. Settings.Secure#ENABLED_INPUT_METHODS speichert InputMethodSubtype#hashCode() als Bezeichner InputMethodSubtype aus historischen Gründen.

Diese API bietet einen sicheren und verwalteten Weg für IME-Entwickler, um zu ändern, was InputMethodSubtype für ihre eigenen IME referenziert Settings.Secure#ENABLED_INPUT_METHODS wird. Ein Anwendungsfall ist, wenn IME-Entwickler ihre eigene Aktivität für Benutzer verwenden möchten, um sie aufzunehmen InputMethodSubtype. Ein weiterer Anwendungsfall ist für IME-Entwickler, alle veralteten und/oder ungültigen Werte zu beheben, die ohne Settings.Secure#ENABLED_INPUT_METHODS Benutzer störend gespeichert sind. Das Übergeben einer leeren subtypeHashCodes Datei ist garantiert, dass der Zustand auf den Standardwert zurückgesetzt wird.

<h3>Zum Steuern des Rückgabewerts von InputMethodSubtype#hashCode()</h3>

android.R.attr#subtypeId und android.view.inputmethod.InputMethodSubtype.InputMethodSubtypeBuilder#setSubtypeId(int) sind für IME-Entwickler verfügbar, um den Rückgabewert von InputMethodSubtype#hashCode(). Achten Sie darauf, dass -1 es sich nicht um einen gültigen Wert aus InputMethodSubtype#hashCode() historischen Gründen handelt.

<h3>Hinweis für Direct Boot Support</h3>

Während IME-Entwickler diese API auch vorher android.os.UserManager#isUserUnlocked()trueaufrufen können, bleibt eine solche Änderung veränderlich und bleibt daher nur wirksam, bis android.os.UserManager#isUserUnlocked()true das Gerät neu gestartet wird. Um die Änderung für beständigen IME-Entwickler vorzunehmen, müssen Sie diese API nach dem Empfang Intent#ACTION_USER_UNLOCKEDerneut aufrufen.

Java Dokumentation für android.view.inputmethod.InputMethodManager.setExplicitlyEnabledInputMethodSubtypes(java.lang.String, int[]).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: