ui.root.setKeyHandler

يضبط معالج أحداث keydown على اللوحة الجذرية باستخدام مفتاح غير محدّد مسبقًا. يتم تشغيل المعالج مرة واحدة فقط عندما يضغط المستخدم على أمر المفتاح المرتبط. سيتم ربط المفتاح نفسه بأحدث معالج تم ضبطه عليه.

الاستخدام	المرتجعات
ui.root.setKeyHandler(keyCode, handler, description)

الوسيطة	النوع	التفاصيل
keyCode	List[ui.Key]|ui.Key	رمز مفتاح أو مصفوفة من رموز المفاتيح على سبيل المثال، ui.Key.A أو [ui.Key.SHIFT, ui.Key.A].
handler	الوظيفة	معالج أمر المفتاح.
description	سلسلة، اختياري	وصف موجز يوضّح وظيفة أمر لوحة المفاتيح هذا سيظهر الوصف في "قائمة الاختصارات".

أمثلة

أداة تعديل الرموز (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');