ui.root.setKeyHandler

یک کنترل‌کننده رویداد keydown را با یک کلید از پیش تعریف نشده به پنل ریشه تنظیم می‌کند. این کنترل‌کننده فقط یک بار زمانی که کاربر دستور کلید مقید را فشار می‌دهد، اجرا می‌شود. همان کلید به آخرین کنترل‌کننده تنظیم شده روی آن مقید خواهد شد.

کاربرد	بازگشت‌ها
ui.root.setKeyHandler(keyCode, handler, description )

استدلال	نوع	جزئیات
keyCode	فهرست[کلید رابط کاربری]|کلید رابط کاربری	یک کد کلید یا آرایه‌ای از کدهای کلید. برای مثال، ui.Key.A یا [ui.Key.SHIFT, ui.Key.A].
handler	عملکرد	کنترل‌کننده‌ی دستور key.
description	رشته، اختیاری	توضیح کوتاهی که این دستور کلیدی را توضیح می‌دهد. این توضیح در منوی میانبرها قابل مشاهده خواهد بود.

مثال‌ها

ویرایشگر کد (جاوااسکریپت)

// Replace the default UI widgets with a few custom widgets.
// Print "Shift A" to the console when Shift+A is pressed.
ui.root.setKeyHandler(
  [ui.Key.SHIFT, ui.Key.A],
  function() {
    print('Shift A');
  },
  'A simple print'
);

// Create a solid black image.
var blackImage = ee.Image(1).visualize({palette: ['black']});

// Create a Layer object so we can easily manipulate its properties.
var blackLayer = ui.Map.Layer(blackImage, {}, 'Black Overlay', true);

// Add the layer to the Map.
Map.layers().add(blackLayer);

// Pressing the "b" key will toggle the layer on and off.
ui.root.setKeyHandler(ui.Key.B, function() {
  // Get the current visibility state.
  var isShown = blackLayer.getShown();

  // Set the visibility to the opposite of the current state.
  blackLayer.setShown(!isShown);

  // Print the status to the console.
  print('Black layer visible: ' + !isShown);
}, 'Toggle black layer');