Google Workspace'teki Özel Menüler

Komut dosyaları, tıklandığında bir Apps Komut Dosyası işlevi yürüten kullanıcı arayüzü öğeleri ekleyerek belirli Google ürünlerini genişletebilir. En yaygın örnek, Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'daki özel bir menü öğesinden komut dosyası çalıştırmaktır. Ancak komut dosyası işlevleri, Google E-Tablolar'daki resim ve çizimler tıklanarak da tetiklenebilir.

Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'da özel menüler

Apps Komut Dosyası, Google Dokümanlar, E-Tablolar, Slaytlar veya Formlar'a yeni menüler ekleyebilir. Her menü öğesi, komut dosyasındaki bir işleve bağlıdır. (Google Formlar'da özel menüler, yalnızca formu değiştirmek için açan bir düzenleyici tarafından görülebilir. Yanıt vermek için formu açan kullanıcılar bu menüleri göremez.)

Bir komut dosyası yalnızca dokümana, e-tabloya veya forma bağlıysa menü oluşturabilir. Kullanıcı bir dosyayı açtığında menüyü görüntülemek için menü kodunu bir onOpen() işlevi içine yazın.

Aşağıdaki örnekte, bir öğe içeren bir menünün ardından bir görsel ayırıcı ve daha sonra başka bir öğe içeren bir alt menünün nasıl ekleneceği gösterilmektedir. (Google E-Tablolar'da yeni sürümü kullanmıyorsanız bunun yerine addMenu() söz dizimini kullanmanız gerektiğini ve alt menülerin kullanılamadığını unutmayın.) Kullanıcı bu menü öğelerinden birini seçtiğinde ilgili işlev bir uyarı iletişim kutusu açar. Açabileceğiniz iletişim kutusu türleri hakkında daha fazla bilgi için iletişim kutuları ve kenar çubukları kılavuzuna bakın.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the second menu item!');
}

Bir doküman, e-tablo, sunu veya formda yalnızca belirli bir ada sahip bir menü bulunabilir. Aynı komut dosyası veya başka bir komut dosyası aynı ada sahip bir menü eklerse yeni menü eskisinin yerini alır. Dosya açıkken menüler kaldırılamaz. Ancak belirli bir özellik ayarlanırsa onOpen() işlevinizi gelecekte menüyü atlayacak şekilde yazabilirsiniz.

Google E-Tablolar'da tıklanabilir resimler ve çizimler

Komut dosyası e-tabloya bağlı olduğu sürece Google E-Tablolar'daki bir resme veya çizime de Apps Komut Dosyası işlevi atayabilirsiniz. Aşağıdaki örnekte bu işlemin nasıl ayarlanacağı gösterilmektedir.

  1. Google E-Tablolar'da, e-tabloya bağlı bir komut dosyası oluşturmak için Uzantılar > Apps Komut Dosyası menü öğesini seçin.

  2. Komut dosyası düzenleyicideki tüm kodları silin ve aşağıdaki kodu yapıştırın.

      function showMessageBox() {
    Browser.msgBox('You clicked it!');
  }

  3. E-Tablolar'a dönün ve Ekle > Resim veya Ekle > Çizim'i seçerek bir resim ya da çizim ekleyin.

  4. Resmi veya çizimi ekledikten sonra tıklayın. Sağ üst köşede küçük bir açılır menü seçici görünür. Bu seçeneği tıklayın ve Komut dosyası atayın'ı seçin.

  5. Görünen iletişim kutusuna, çalıştırmak istediğiniz Apps Komut Dosyası işlevinin adını parantez olmadan yazın (bu örnekte showMessageBox). Tamam'ı tıklayın.

  6. Resmi veya çizimi tekrar tıklayın. İşlev artık yürütülür.