鍵盤快速鍵小幫手可讓使用者找到適用於 平台和開啟應用程式在鍵盤快速鍵輔助程式中發布應用程式捷徑 進而提高使用者的工作效率和使用便利性
使用者按下 Meta+/ 鍵即可開啟鍵盤快速鍵畫面, 適用於 Android 7.0 (API 級別 24) 以上版本。
![在裝置上開啟應用程式顯示系統捷徑。](https://developer.android.com/static/images/develop/ui/touch-input/keyboard-input/keyboard_shortcut_helper.png?authuser=1&hl=zh-tw)
提供鍵盤快速鍵輔助程式的捷徑
你可以提供鍵盤快速鍵清單
使用鍵盤快速鍵輔助功能,
onProvideKeyboardShortcuts()
視窗回呼。
下列程式碼片段示範了
onProvideKeyboardShortcuts()
可新增一組四個捷徑:
class MainActivity : ComponentActivity() {
// Activity codes such as overridden onStart method.
override fun onProvideKeyboardShortcuts(
data: MutableList<KeyboardShortcutGroup>?,
menu: Menu?,
deviceId: Int
) {
val shortcutGroup = KeyboardShortcutGroup(
"Cursor movement",
listOf(
KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
)
)
data?.add(shortcutGroup)
}
}
KeyboardShortcutInfo
提供鍵盤快速鍵的說明。
鍵盤快速鍵清單會包裝成
KeyboardShortcutGroup
物件。
應用程式會在資訊清單中新增
將 KeyboardShortcutGroup
物件傳遞至可變動清單
做為方法的第一個參數
使用群組整理鍵盤快速鍵
鍵盤快速鍵小幫手會顯示不同群組的鍵盤快速鍵 方便使用者根據用途或 圖 2 顯示鍵盤快速鍵 分成兩組:遊標移動和訊息編輯。
![應用程式會在顯示捷徑群組的裝置中開啟。](https://developer.android.com/static/images/develop/ui/touch-input/keyboard-input/keyboard_shortcut_group.png?authuser=1&hl=zh-tw)
應用程式會註冊兩個以上的鍵盤快速鍵群組,
每個群組的 KeyboardShortcutGroup
物件。
在以下程式碼片段中,系統會將兩個 KeyboardShortCutGroup
物件新增至
傳遞至 onProvideKeyboardShortcuts()
方法的可變動清單。
物件會在鍵盤快速鍵輔助程式中顯示為類別,如
圖 2 所示。
override fun onProvideKeyboardShortcuts(
data: MutableList<KeyboardShortcutGroup>?,
menu: Menu?,
deviceId: Int
) {
val cursorMovement = KeyboardShortcutGroup(
"Cursor movement",
listOf(
KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
)
)
val messageEdit = KeyboardShortcutGroup(
"Message editing",
listOf(
KeyboardShortcutInfo("Select All", KeyEvent.KEYCODE_A, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Send a message", KeyEvent.KEYCODE_ENTER, KeyEvent.META_SHIFT_ON)
)
)
data?.add(cursorMovement)
data?.add(messageEdit)
}
透過程式碼開啟鍵盤快速鍵輔助程式
應用程式會透過以下方式顯示鍵盤快速鍵畫面:
呼叫 requestShowKeyboardShortcuts()
方法。在以下程式碼片段中,當使用者輕觸
或按一下按鈕或按下 Enter 鍵。
val activity = LocalContext.current as Activity
Button(onClick = { activity.requestShowKeyboardShortcuts() }) {
Text(text = "Show keyboard shortcuts")
}