Sunuda öğeleri seçme

Seçim, açık bir sunu sayfasında şu anda seçili olan öğedir (ör. vurgulanan metin veya tablo). Bu kılavuzda, Apps Komut Dosyası'nı kullanarak etkin bir sunudaki seçimi nasıl alacağınız ve ayarlayacağınız açıklanmaktadır.

Seçim, komut dosyası başladığında mevcut olan durumun anlık görüntüsüdür. Kullanıcı tıkladığında ve komut dosyası çalışırken seçim değişirse bu değişiklikler yansıtılmaz.

Seçimler ve seçim türü

Selection sınıfını kullanarak seçimi okuyabilirsiniz. Sınıf, seçilen nesnelerin türüne göre seçilen nesneleri almak için çeşitli yöntemlere sahiptir.

SelectionType enum, seçilen nesnelerin türünü temsil eder. Örneğin, kullanıcı bir şekilde metin seçtiyse seçim türü TEXT olur. Bu durumda, selection.getTextRange() yöntemini kullanarak seçili metin aralığını alabilirsiniz.

Seçimi içeren nesneyi de alabilirsiniz. Yukarıdaki örnekte devam edersek selection.getPageElementRange().getPageElements()[0] kullanarak seçili metni içeren şekli alabilirsiniz. Benzer şekilde, kapsayıcı şekli içeren sayfa geçerli etkin sayfadır. Bu sayfayı almak için selection.getCurrentPage() öğesini kullanın.

Seçimi okuma

Seçimi okumak için aşağıdaki örnekte gösterildiği gibi Presentation.getSelection() yöntemini kullanın:

slides/selection/selection.gs
const selection = SlidesApp.getActivePresentation().getSelection();

Mevcut sayfayı okuma

Kullanıcının görüntülediği mevcut sayfayı almak için getSelection() ve getCurrentPage() yöntemlerini aşağıdaki gibi kullanın:

slides/selection/selection.gs
const currentPage = SlidesApp.getActivePresentation().getSelection().getCurrentPage();

Geçerli sayfanın aşağıdaki türlerden biri olabileceğini unutmayın:

Geçerli sayfada bir veya daha fazla nesne seçili olabilir. Seçim türünü SelectionType belirler.

Seçim türüne göre seçimi okuma

Aşağıdaki örnekte, mevcut seçimi türe uygun bir şekilde okumak için seçim türünü nasıl kullanabileceğiniz gösterilmektedir.

slides/selection/selection.gs
const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
let currentPage;
switch (selectionType) {
  case SlidesApp.SelectionType.NONE:
    console.log('Nothing selected');
    break;
  case SlidesApp.SelectionType.CURRENT_PAGE:
    currentPage = selection.getCurrentPage();
    console.log('Selection is a page with ID: ' + currentPage.getObjectId());
    break;
  case SlidesApp.SelectionType.PAGE_ELEMENT:
    const pageElements = selection.getPageElementRange().getPageElements();
    console.log('There are ' + pageElements.length + ' page elements selected.');
    break;
  case SlidesApp.SelectionType.TEXT:
    const tableCellRange = selection.getTableCellRange();
    if (tableCellRange !== null) {
      const tableCell = tableCellRange.getTableCells()[0];
      console.log('Selected text is in a table at row ' +
        tableCell.getRowIndex() + ', column ' +
        tableCell.getColumnIndex());
    }
    const textRange = selection.getTextRange();
    if (textRange.getStartIndex() === textRange.getEndIndex()) {
      console.log('Text cursor position: ' + textRange.getStartIndex());
    } else {
      console.log('Selection is a text range from: ' + textRange.getStartIndex() + ' to: ' +
        textRange.getEndIndex() + ' is selected');
    }
    break;
  case SlidesApp.SelectionType.TABLE_CELL:
    const tableCells = selection.getTableCellRange().getTableCells();
    const table = tableCells[0].getParentTable();
    console.log('There are ' + tableCells.length + ' table cells selected.');
    break;
  case SlidesApp.SelectionType.PAGE:
    const pages = selection.getPageRange().getPages();
    console.log('There are ' + pages.length + ' pages selected.');
    break;
  default:
    break;
}

Metin seçimlerini okuma

Selection.getTextRange() yöntemini kullanarak metin seçimini okuyabilirsiniz. İki tür metin seçimi vardır:

  • Aralık seçimi: Bir şekil "Merhaba" metnini içeriyorsa ve "O" seçilirse döndürülen aralık startIndex=0 ve endIndex=2 değerine sahiptir.
  • İmleç seçimi: Bir şekil "Merhaba" metnini içeriyorsa ve imleç "H"den sonraysa ("H|merhaba") döndürülen aralık, startIndex=1 ve endIndex=1 ile boş aralıktır.

Seçimi değiştirme

Komut dosyası, kullanıcının seçimini değiştirebilir. Komut dosyasının sunumda yaptığı tüm seçim değişiklikleri, komut dosyası çalıştırıldığı sürece sonraki seçim işlemlerine yansıtılır.

Seçim değişiklikleri, yalnızca komut dosyası çalıştırma işlemi tamamlandıktan sonra veya Presentation.saveAndClose() çağrıldığında kullanıcının tarayıcıya yansıtılır.

Geçerli sayfayı seçme

selectAsCurrentPage() yöntemi çağrılarak etkin sunudaki bir sayfa geçerli sayfa olarak seçilebilir. Bu yöntem, önceki sayfa öğelerini, sayfaları veya metin seçimlerini kaldırır. Bu nedenle, mevcut sayfada bu yöntemi kullandığınızda sayfadaki mevcut seçimlerin seçimini kaldırabilirsiniz. Örneğin:

slides/selection/selection.gs
// Select the first slide as the current page selection and remove any previous selection.
  const selection = SlidesApp.getActivePresentation().getSelection();
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.selectAsCurrentPage();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.CURRENT_PAGE
// selection.getCurrentPage() = slide
//

Sayfa öğesi seçme

Sayfada bir sayfa öğesi seçmek için PageElement.select() yöntemini kullanın. Bu işlem, önceden seçili olan sayfa öğelerinin de seçimini kaldırır.

Örneğin:

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const pageElement = slide.getPageElements()[0];
  // Only select this page element and remove any previous selection.
  pageElement.select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = pageElement
//

Birden fazla sayfa öğesi seçme

Seçime başka sayfa öğeleri eklemek için PageElement.select(false) yöntemini kullanın. Tüm sayfa öğeleri geçerli sayfada olmalıdır.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // First select the slide page, as the current page selection.
  slide.selectAsCurrentPage();
  // Then select all the page elements in the selected slide page.
  const pageElements = slide.getPageElements();
  for (let i = 0; i < pageElements.length; i++) {
    pageElements[i].select(false);
  }
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = pageElements
//

Seçimi dönüştürme

Komut dosyanızın yaptığı düzenlemeler, mevcut seçimi dönüştürebilir. Böylece, düzenleme sonucunda seçilen öğe değişir. Örneğin:

  1. A ve B adlı iki şekli seçtiğinizi varsayalım.
  2. Ardından komut dosyanız A şeklini kaldırır.
  3. Sonuç olarak, seçim düzenlemeye göre dönüştürülür ve yalnızca B şekli seçilir.

Aşağıdaki örnekte, seçilen sayfa öğeleriyle oynanarak seçimin nasıl dönüştürülebileceği gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape1 = slide.getPageElements()[0].asShape();
  const shape2 = slide.getPageElements()[1].asShape();
  // Select both the shapes.
  shape1.select();
  shape2.select(false);
  // State of selection
  //
  // selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
  // selection.getCurrentPage() = slide
  // selection.getPageElementRange().getPageElements() = [shape1, shape2]
  //
  // Remove one shape.
  shape2.remove();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = [shape1]
//

Metin seçme

Bir şekilde veya tablo hücresinde bulunan metin, TextRange.select() yöntemi kullanılarak seçilebilir. Metin bir şekilde yer alıyorsa bu şekil de seçilir. Metin bir tablo hücresindeyse hem söz konusu tablo hücresi hem de onu içeren tablo seçilir.

Bu işlem, üst sayfayı geçerli sayfa olarak da ayarlar.

Bir şekilde aralık seçimi

Aşağıdaki örnekte, bir şekle yerleştirilmiş metin içinde nasıl aralık seçimi yapılacağı gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  shape.getText().setText('Hello');
  // Range selection: Select the text range 'He'.
  shape.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

Bir şekilde imleci seçin

Aşağıdaki örnekte, bir şekildeki metin içinde nasıl imleç seçimi yapılacağı gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  shape.getText().setText('Hello');
  // Cursor selection: Place the cursor after 'H' like 'H|ello'.
  shape.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

Tablo hücresinde aralık seçimi

Aşağıdaki örnekte, bir tablo hücresindeki metin içinde aralık seçiminin nasıl yapılacağı gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const table = slide.getPageElements()[0].asTable();
  const tableCell = table.getCell(0, 1);
  tableCell.getText().setText('Hello');
  // Range selection: Select the text range 'He'.
  tableCell.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

TableCell'de imleç seçimi

Aşağıdaki örnekte, bir tablo hücresindeki metinde nasıl imleç seçimi yapılacağı gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const table = slide.getPageElements()[0].asTable();
  const tableCell = table.getCell(0, 1);
  tableCell.getText().setText('Hello');
  // Cursor selection: Place the cursor after 'H' like 'H|ello'.
  tableCell.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

Metin düzenlemeleri içeren seçim dönüşümü

Aşağıdaki örnekte, seçili metin düzenlenerek seçimin nasıl dönüştürülebileceği gösterilmektedir.

slides/selection/selection.gs
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  const textRange = shape.getText();
  textRange.setText('World');
  // Select all the text 'World'.
  textRange.select();
  // State of selection
  //
  // selection.getSelectionType() = SlidesApp.SelectionType.TEXT
  // selection.getCurrentPage() = slide
  // selection.getPageElementRange().getPageElements()[0] = shape
  // selection.getTextRange().getStartIndex() = 0
  // selection.getTextRange().getEndIndex() = 6
  //
  // Add some text to the shape, and the selection will be transformed.
  textRange.insertText(0, 'Hello ');

// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 12
//

Seçimi kaldırma

Metin veya sayfa öğelerinin seçimini kaldırmak için açık bir yöntem yoktur. Ancak bu sonuç, Page.selectAsCurrentPage() veya pageElement.select() yöntemleri kullanılarak elde edilebilir.

Mevcut bir sayfayı seçme

Aşağıdaki örnekte, bir sayfayı geçerli sayfa olarak ayarlayarak sayfadaki mevcut seçimlerin nasıl kaldırılacağı gösterilmektedir.

slides/selection/selection.gs
// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected, setting the
// same (or any other) slide page as the current page would do the unselect.
//
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.selectAsCurrentPage();

Sayfa öğesi seçme

Aşağıdaki örnekte, bir sayfa öğesi seçilerek sayfadaki mevcut tüm seçimlerin nasıl kaldırılacağı gösterilmektedir. Böylece diğer tüm öğeler seçimden kaldırılır.

slides/selection/selection.gs
// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected,
// selecting any pageElement in the first slide (or any other pageElement) would
// do the unselect and select that pageElement.
//
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.getPageElements()[0].select();