blockly > ShortcutRegistry

Lớp ShortcutRegistry

Lớp cho sổ đăng ký phím tắt. Đây là một singleton. Bạn không nên tạo một thực thể mới và chỉ truy cập vào lớp này từ ShortcutRegistry.registry.

Chữ ký:

export declare class ShortcutRegistry 

Thuộc tính

Thuộc tính Đối tượng sửa đổi Loại Mô tả
sổ đăng ký

static

readonly

ShortcutRegistry

Phương thức

Phương thức Đối tượng sửa đổi Mô tả
addKeyMapping(keyCode, shortcutName, allowCollision)

Thêm mối liên kết giữa mã phím và phím tắt.

Thông thường, bạn chỉ có thể liên kết một lối tắt với bất kỳ mã phím nào, nhưng việc đặt allowCollisions thành true cho phép liên kết một bàn phím với nhiều lối tắt. Trong trường hợp đó, khi onKeyDown được gọi bằng một thao tác nhấn phím nhất định, phương thức này sẽ xử lý các phím tắt đã liên kết theo thứ tự đảo ngược, từ phím tắt được liên kết gần đây nhất đến phím tắt được liên kết gần đây nhất).

createSerializedKey(keyCode, modifiers) Tạo mã khoá được chuyển đổi tuần tự sẽ được dùng trong bản đồ khoá.
getKeyCodesByShortcutName(shortcutName) Lấy các mã khoá đã chuyển đổi tuần tự mà lối tắt có tên đã cho được đăng ký.
getKeyMap() Lấy bản đồ khoá hiện tại.
getRegistry() Lấy sổ đăng ký phím tắt.
getShortcutNamesByKeyCode(keyCode) Lấy các phím tắt đã đăng ký cho mã phím đã cho.
onKeyDown(workspace, e)

Xử lý các sự kiện nhấn phím.

– Mọi KeyboardShortcut được liên kết với mã phím gây ra sự kiện e sẽ được xử lý, theo thứ tự từ ít đến nhiều lần đăng ký gần đây nhất. – Nếu preconditionFn của lối tắt tồn tại, thì lối tắt đó sẽ được gọi. Nếu preconditionFn trả về giá trị false, hàm callback của lối tắt sẽ bị bỏ qua. Quá trình xử lý sẽ tiếp tục với lối tắt tiếp theo (nếu có). – Sau đó, hàm callback của lối tắt sẽ được gọi. Nếu giá trị trả về là true, quá trình xử lý sẽ kết thúc và onKeyDown sẽ trả về true. Nếu trả về giá trị false, quá trình xử lý sẽ tiếp tục với lối tắt tiếp theo (nếu có). – Nếu tất cả lối tắt đã đăng ký cho mã phím đã cho đã được xử lý mà không có lối tắt nào trả về true, thì onKeyDown sẽ trả về false.

register(shortcut, allowOverrides) Đăng ký một phím tắt.
removeAllKeyMappings(shortcutName) Xoá tất cả các mối liên kết phím cho một lối tắt có tên đã cho. Hữu ích khi thay đổi các mối liên kết phím mặc định và không biết mã phím đã đăng ký cho lối tắt.
removeKeyMapping(keyCode, shortcutName, quiet) Xoá mối liên kết giữa mã phím và phím tắt.
reset() Xoá và tạo lại sổ đăng ký và keyMap.
setKeyMap(newKeyMap) Đặt bản đồ phím. Việc đặt bản đồ phím sẽ ghi đè mọi bản đồ phím mặc định.
unregister(shortcutName) Huỷ đăng ký phím tắt đã đăng ký bằng tên đã cho. Thao tác này cũng sẽ xoá mọi mối liên kết phím tham chiếu đến lối tắt này.