Google Workspace'teki Özel Menüler

Komut dosyaları, tıklandığında bir Apps Komut Dosyası işlevini 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'da özel bir menü öğesinden komut dosyası çalıştırmaktır. Ancak komut dosyası işlevleri, Google E-Tablolar'da resimler 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'da her menü öğesi bir komut dosyasındaki bir işleve bağlı olacak şekilde yeni menüler ekleyebilir. (Google Formlar'da özel menüler, yalnızca formu değiştirmek için formu açan düzenleyen tarafından görülebilir, yanıt vermek için formu açan kullanıcılar tarafından görülemez.)

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

Aşağıdaki örnekte bir öğeli menü, ardından bir görsel ayırıcı ve ardından başka bir öğe içeren alt menü ekleme 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ılamayacağını unutmayın.) Kullanıcı menü öğelerinden birini seçtiğinde, karşılık gelen işlev bir uyarı iletişim kutusu açar. Açabileceğiniz iletişim kutusu türleri hakkında daha fazla bilgi edinmek için iletişim kutusu ve kenar çubuğu rehberine 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, belli bir ada sahip yalnızca tek 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 ayarlanmışsa gelecekte menüyü atlamak için onOpen() işlevinizi yazabilirsiniz.

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

Ayrıca, komut dosyası e-tabloya bağlı olduğu sürece Google E-Tablolar'daki bir resme veya çizime Apps Komut Dosyası işlevi atayabilirsiniz. Aşağıdaki örnekte bunun 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 kodu 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 veya çizim ekleyin.

  4. Resmi veya çizimi ekledikten sonra ilgili resmi veya çizimi tıklayın. Sağ üst köşede küçük bir açılır menü seçici görünür. Simgeyi tıklayın ve Komut dosyası ata'yı seçin.

  5. Açılan iletişim kutusunda, ç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 yürütülür.