ui.root.setKeyHandler

מגדיר גורם מטפל באירועים של אירוע keydown לחלונית הבסיס עם מקש שלא הוגדר מראש. ה-handler מופעל רק פעם אחת כשמשתמש לוחץ על פקודת המקשים שמוגדרת. אותו מפתח יקשר ל-handler העדכני ביותר שהוגדר לו.

שימוש	החזרות
ui.root.setKeyHandler(keyCode, handler, description)

ארגומנט	סוג	פרטים
keyCode	List[ui.Key]|ui.Key	קוד מקש או מערך של קודי מקשים. לדוגמה, ui.Key.A או [ui.Key.SHIFT, ui.Key.A].
handler	פונקציה	ה-handler של פקודת המפתח.
description	מחרוזת, אופציונלי	תיאור קצר שמסביר את פקודת המקשים הזו. התיאור יוצג בתפריט קיצורי הדרך.

דוגמאות

Code Editor (JavaScript)

// 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');