Class Ui

Kullanıcının düzenleyicisinde, belirtilen mesajın ve "Tamam" ifadesinin yer aldığı bir iletişim kutusu açar düğmesini tıklayın. Bu yöntem iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası, kullanıcı sonrasında devam ettirilir iletişim kutusunu kapatır, ancak Jdbc bağlantılarına ve LockService kilidine askıya alınma durumunda kalır. Daha fazla bilgi için iletişim kutusu ve kenar çubuğu rehberine bakın.

// Display "Hello, world" in a dialog box with an "OK" button. The user can also close the
// dialog by clicking the close button in its title bar.
SpreadsheetApp.getUi().alert('Hello, world');

Parametreler

Return

Button - Kullanıcının tıkladığı düğme.

Kullanıcının düzenleyicisinde, verilen iletiyi ve düğme grubunu içeren bir iletişim kutusu açar. Bu yöntem iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası, kullanıcı sonrasında devam ettirilir iletişim kutusunu kapatır, ancak Jdbc bağlantılarına ve LockService kilidine askıya alınma durumunda kalır. Daha fazla bilgi için iletişim kutusu ve kenar çubuğu rehberine bakın.

// Display a dialog box with a message and "Yes" and "No" buttons. The user can also close the
// dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.alert('Are you sure you want to continue?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response == ui.Button.YES) {
  Logger.log('The user clicked "Yes."');
} else {
  Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.');
}

Parametreler

Return

Button - Kullanıcının tıkladığı düğme.

Kullanıcının düzenleyicisinde belirtilen başlık, ileti ve düğme grubunu içeren bir iletişim kutusu açar. Bu yöntemi, iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası, kullanıcı iletişim kutusunu kapatır, ancak Jdbc bağlantılarına ve LockService kilidine askıya alınma durumunda kalır. Daha fazla bilgi için iletişim kutusu ve kenar çubuğu rehberine bakın.

// Display a dialog box with a title, message, and "Yes" and "No" buttons. The user can also
// close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.alert('Confirm', 'Are you sure you want to continue?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response == ui.Button.YES) {
  Logger.log('The user clicked "Yes."');
} else {
  Logger.log('The user clicked "No" or the close button in the dialog\'s title bar.');
}

Parametreler

Return

Button - Kullanıcının tıkladığı düğme.

Düzenleyicinin Uzantılar menüsüne alt menü eklemek için kullanılabilecek bir oluşturucu oluşturur. İlgili içeriği oluşturmak için kullanılan menü, Menu.addToUi() çağrılana kadar güncellenmez. Komut dosyası çalışıyorsa alt menü adı, eklentinin web mağazasındaki adıyla eşleşir; Komut dosyası doğrudan dokümana bağlıysa alt menü adı komut dosyasının adıyla eşleşir. Daha fazla bilgi için menü rehberine bakın.

// Add an item to the Add-on menu, under a sub-menu whose name is set automatically.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createAddonMenu()
      .addItem('Show', 'showSidebar')
      .addToUi();
}

Return

Menu: Yeni menü oluşturucu.

Düzenleyicinin kullanıcı arayüzüne menü eklemek için kullanılabilecek bir oluşturucu oluşturur. Menü aslında Menu.addToUi() çağrılana kadar eklenmelidir. Daha fazla bilgi için menü rehberine bakın. Üst düzey menü etiketi bir alt menünün etiketi Normal tümce düzeni (yalnızca ilk kelime büyük harfle yazılmalıdır). Komut dosyası bir eklenti olarak yayınlanırsa caption parametresi yoksayılır ve menüsü, Uzantılar menüsünün alt menüsü olarak eklenir (createAddonMenu() eşdeğeri).

// Add a custom menu to the active document, including a separator and a sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Parametreler

Return

Menu: Yeni menü oluşturucu.

Kullanıcının düzenleyicisinde, verilen mesajı ve "Tamam"ı içeren bir giriş iletişim kutusu açar düğmesini tıklayın. Bu yöntemi, iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası, kullanıcı iletişim kutusunu kapatır, ancak Jdbc bağlantılarına ve LockService kilidine askıya alınma durumunda kalır. Daha fazla bilgi için iletişim kutusu ve kenar çubuğu rehberine bakın.

// Display a dialog box with a message, input field, and an "OK" button. The user can also
// close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('Enter your name:');

// Process the user's response.
if (response.getSelectedButton() == ui.Button.OK) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parametreler

Return

PromptResponse: Kullanıcının yanıtının temsilidir.

Kullanıcının düzenleyicisinde, verilen iletiyi ve düğme grubunu içeren bir giriş iletişim kutusu açar. Bu yöntemi, iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası, kullanıcı iletişim kutusunu kapatır, ancak Jdbc bağlantılarına ve LockService kilidine askıya alınma durumunda kalır. Daha fazla bilgi için iletişim kutusu ve kenar çubuğu rehberine bakın.

// Display a dialog box with a message, input field, and "Yes" and "No" buttons. The user can
// also close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('May I know your name?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response.getSelectedButton() == ui.Button.YES) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() == ui.Button.NO) {
  Logger.log('The user didn\'t want to provide a name.');
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parametreler

Return

PromptResponse: Kullanıcının yanıtının temsilidir.

Kullanıcının düzenleyicisinde belirtilen başlık, ileti ve kümeyi içeren bir giriş iletişim kutusu açar düğmelerini kullanın. Bu yöntem, iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya alır. Komut dosyası kullanıcı iletişim kutusunu kapattıktan sonra devam eder, ancak Jdbc bağlantıları ve LockService kilitleri askıya alınır. Daha fazla bilgi için kılavuzu iletişim kutuları ve kenar çubukları'nı tıklayın.

// Display a dialog box with a title, message, input field, and "Yes" and "No" buttons. The
// user can also close the dialog by clicking the close button in its title bar.
var ui = SpreadsheetApp.getUi();
var response = ui.prompt('Getting to know you', 'May I know your name?', ui.ButtonSet.YES_NO);

// Process the user's response.
if (response.getSelectedButton() == ui.Button.YES) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() == ui.Button.NO) {
  Logger.log('The user didn\'t want to provide a name.');
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Parametreler

Return

PromptResponse: Kullanıcının yanıtının temsilidir.

Kullanıcının düzenleyicisinde, istemci tarafı özel içerikle kalıcı bir iletişim kutusu açar. Bu yöntem askıya almama. Müşteriyle iletişim kurmak için komut dosyası kullanıyorsanız, istemci tarafı bileşeninin HtmlService için google.script API'sini kullanarak eşzamansız geri çağırmalar yapması gerekir. İletişim kutusunu kapatmak için programatik olarak, şunu çağırın: HtmlService web'in istemci tarafında google.script.host.close() uygulamasını indirin. Daha fazla bilgi için bkz. iletişim kutuları rehberi ve kenar çubukları.

Kalıcı iletişim kutuları, kullanıcının iletişim kutusu dışında herhangi bir şeyle etkileşim kurmasını engeller. Ölçüt kontrast, modsuz iletişim kutuları ve kenar çubukları, kullanıcının düzenleyiciyle etkileşimde bulunmasını sağlar. Neredeyse her senaryoda kalıcı iletişim kutusu veya kenar çubuğu, modsuz iletişim kutusundan daha iyi bir seçenektir.

// Display a modal dialog box with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setWidth(250)
    .setHeight(300);
SpreadsheetApp.getUi().showModalDialog(htmlOutput, 'My add-on');

Parametreler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

• https://www.googleapis.com/auth/script.container.ui

Kullanıcının düzenleyicisinde, özel istemci tarafı içerikle modsuz bir iletişim kutusu açar. Bu yöntem iletişim kutusu açıkken sunucu tarafı komut dosyasını askıya almaz. Müşteriyle iletişim kurmak için komut dosyası kullanıyorsanız, istemci tarafı bileşeninin HtmlService için google.script API'sini kullanarak eşzamansız geri çağırmalar yapması gerekir. İletişim kutusunu kapatmak için programatik olarak, şunu çağırın: HtmlService web'in istemci tarafında google.script.host.close() uygulamasını indirin. Daha fazla bilgi için bkz. iletişim kutuları rehberi ve kenar çubukları.

Modsuz iletişim kutuları, kullanıcının iletişim kutusunun arkasındaki düzenleyiciyle etkileşimde bulunmasına olanak tanır. Buna karşılık, modal iletişim kutuları için bu geçerli değildir. Neredeyse her senaryoda, iletişim kutusu veya kenar çubuğu, modsuz iletişim kutusundan daha iyi bir seçenektir.

// Display a modeless dialog box with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setWidth(250)
    .setHeight(300);
SpreadsheetApp.getUi().showModelessDialog(htmlOutput, 'My add-on');

Parametreler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

• https://www.googleapis.com/auth/script.container.ui

Kullanıcının düzenleyicisinde, istemci tarafı özel içerikle bir kenar çubuğu açar. Bu yöntem Kenar çubuğu açıkken sunucu tarafı komut dosyasını askıya almayın. Müşteriyle iletişim kurmak için komut dosyası kullanıyorsanız, istemci tarafı bileşeninin HtmlService için google.script API'sini kullanarak eşzamansız geri çağırmalar yapması gerekir. Kenar çubuğunu kapatmak için programatik olarak, şunu çağırın: HtmlService web'in istemci tarafında google.script.host.close() uygulamasını indirin. Daha fazla bilgi için bkz. iletişim kutuları rehberi ve kenar çubukları.

Kenar çubuğu, ortamlarında bir uzantı kullanan kullanıcılar için düzenleyicinin sağ tarafında soldan sağa ve sağdan sola diller için düzenleyicinin sol tarafında yer alır. Tümü komut dosyaları tarafından gösterilen kenar çubukları 300 piksel genişliğindedir.

// Display a sidebar with custom HtmlService content.
var htmlOutput = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My add-on');
SpreadsheetApp.getUi().showSidebar(htmlOutput);

Parametreler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

• https://www.googleapis.com/auth/script.container.ui