語言

InputMethodService.OnCustomImeSwitcherButtonRequestedVisible(Boolean) 方法

定義

當自訂 IME 切換器按鈕的請求顯示改變時會被呼叫。

[Android.Runtime.Register("onCustomImeSwitcherButtonRequestedVisible", "(Z)V", "GetOnCustomImeSwitcherButtonRequestedVisible_ZHandler", ApiSince=36)]
public virtual void OnCustomImeSwitcherButtonRequestedVisible(bool visible);
[<Android.Runtime.Register("onCustomImeSwitcherButtonRequestedVisible", "(Z)V", "GetOnCustomImeSwitcherButtonRequestedVisible_ZHandler", ApiSince=36)>]
abstract member OnCustomImeSwitcherButtonRequestedVisible : bool -> unit
override this.OnCustomImeSwitcherButtonRequestedVisible : bool -> unit

參數

visible
Boolean

不管按鈕是否被要求顯示。

屬性

備註

當自訂 IME 切換器按鈕的請求顯示改變時會被呼叫。

當系統以 true 調用此方法時,IME 必須在其介面中顯示一個按鈕來切換 IME。 當它被 false 呼叫時,必須隱藏這個按鈕。

通常系統會提供一個按鈕,讓你在適當時切換到不同的 IME。 在某些情況下,例如當 IME 成功要求隱藏系統提供的導航列(使用 getWindowInsetsController().hide(captionBar())),前提是這個按鈕透過回調授權給 IME。

這不取決於IME目前的能見度。 當 IME 隱藏時,可能會用 true 來呼叫,這時 IME 應該在 IME 顯示時就準備顯示這個按鈕。

只有當請求的可見性改變時才會呼叫此通知。 預設值為 false,因此若結果值為 false,則不會初次呼叫此值。

即使 IME 目前看不到,也可以在 onCreate() 之後隨時呼叫這個功能。 不過,這不保證會在 IME 顯示前被呼叫,因為這取決於 IME 是否請求隱藏系統提供的導航列。 若請求是在顯示流程期間(例如在 onStartInputView(EditorInfo, boolean))中傳送,則會在 onWindowShown() 後不久、第一幀 IME 畫出前被呼叫。

Android 參考資料。android.inputmethodservice.InputMethodService.onCustomImeSwitcherButtonRequestedVisible

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於