प्रज़ेंटेशन में आइटम चुनना

चुना गया कॉन्टेंट वह कॉन्टेंट होता है जो किसी खुले प्रज़ेंटेशन पेज में चुना गया हो. जैसे, हाइलाइट किया गया टेक्स्ट या टेबल. इस गाइड से आपको Apps Script का इस्तेमाल करके, किसी चालू प्रज़ेंटेशन में चुनने और चुनने का तरीका पता चलता है.

स्क्रिप्ट, सिर्फ़ उस उपयोगकर्ता के चुने गए डेटा को ऐक्सेस कर सकती है जो स्क्रिप्ट चला रहा है.

चुना गया डेटा, स्क्रिप्ट शुरू होने के समय का स्नैपशॉट होता है. अगर स्क्रिप्ट चलने के दौरान उपयोगकर्ता क्लिक करता है और चुना गया विकल्प बदल जाता है, तो वे बदलाव नहीं दिखेंगे.

चुनाव और उनका टाइप

Selection क्लास का इस्तेमाल करके, चुने गए हिस्से को पढ़ा जा सकता है. चुने गए ऑब्जेक्ट के टाइप के आधार पर, उन्हें पाने के लिए क्लास में कई तरीके होते हैं.

SelectionType एनम, चुने गए ऑब्जेक्ट के खास टाइप को दिखाता है. उदाहरण के लिए, अगर उपयोगकर्ता ने किसी आकार में कुछ टेक्स्ट चुना है, तो चुने गए टेक्स्ट का टाइप TEXT होगा. इस मामले में, selection.getTextRange() तरीके का इस्तेमाल करके, चुने गए टेक्स्ट की रेंज को वापस पाया जा सकता है.

आपके पास चुने गए ऑब्जेक्ट को भी वापस पाने का विकल्प है. ऊपर दिए गए उदाहरण के आधार पर, selection.getPageElementRange().getPageElements()[0] का इस्तेमाल करके, चुने गए टेक्स्ट वाले आकार को वापस पाया जा सकता है. इसी तरह, जिस पेज में क्लोज़िंग शेप मौजूद है, वह मौजूदा ऐक्टिव पेज है. उस पेज को वापस पाने के लिए, selection.getCurrentPage() का इस्तेमाल करें.

चुने गए सुझाव पढ़े जा रहे हैं

चुने गए टेक्स्ट को पढ़ने के लिए, Presentation.getSelection() मैथड का इस्तेमाल करें, जैसा कि इस उदाहरण में दिखाया गया है:

slides/selection/selection.gs

GitHub पर देखना

const selection = SlidesApp.getActivePresentation().getSelection();

मौजूदा पेज को पढ़ना

उपयोगकर्ता जिस मौजूदा पेज को देख रहा है उसे वापस पाने के लिए, getSelection() और getCurrentPage() तरीकों का इस्तेमाल इस तरह करें:

slides/selection/selection.gs

GitHub पर देखना

const currentPage = SlidesApp.getActivePresentation().getSelection().getCurrentPage();

ध्यान दें कि मौजूदा पेज इनमें से किसी भी तरह का हो सकता है:

• स्लाइड
• मास्टर
• लेआउट

मौजूदा पेज पर एक या उससे ज़्यादा ऑब्जेक्ट चुने जा सकते हैं. साथ ही, SelectionType से चुने गए ऑब्जेक्ट का टाइप तय होता है.

चुने गए विकल्प के टाइप के आधार पर, चुना गया विकल्प पढ़ना

यहां दिए गए उदाहरण में बताया गया है कि चुने गए आइटम को सही तरीके से पढ़ने के लिए, चुने गए आइटम के टाइप के हिसाब से, चुने गए आइटम के टाइप का इस्तेमाल कैसे किया जा सकता है.

slides/selection/selection.gs

GitHub पर देखना

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;
}

चुने गए टेक्स्ट को पढ़ना

Selection.getTextRange() तरीके का इस्तेमाल करके, चुने गए टेक्स्ट को पढ़ा जा सकता है. टेक्स्ट चुनने के दो टाइप होते हैं:

• रेंज चुनना: अगर किसी आकार में "नमस्ते" टेक्स्ट है और "नमस्ते" चुना गया है, तो दिखाई गई रेंज में startIndex=0 और endIndex=2 होगा.
• कर्सर से चुना गया टेक्स्ट: अगर किसी आकार में "नमस्ते" टेक्स्ट है और कर्सर "ह" ("ह|नमस्ते") के बाद है, तो दिखाई गई रेंज खाली होगी. इसमें startIndex=1 और endIndex=1 होगा.

चुने गए हिस्से में बदलाव किया जा रहा है

स्क्रिप्ट, उपयोगकर्ता के चुने गए विकल्प में बदलाव कर सकती है. स्क्रिप्ट की मदद से प्रज़ेंटेशन में चुने गए आइटम में किए गए बदलाव, स्क्रिप्ट के चलने के दौरान चुने गए आइटम में दिखते हैं.

चुने गए विकल्प में हुए बदलाव, उपयोगकर्ता के ब्राउज़र पर सिर्फ़ तब दिखते हैं, जब स्क्रिप्ट का रन होना पूरा हो जाता है या Presentation.saveAndClose() को कॉल किया जाता है.

मौजूदा पेज चुनना

selectAsCurrentPage() तरीके को कॉल करके, चालू प्रज़ेंटेशन में किसी पेज को मौजूदा पेज के तौर पर चुना जा सकता है. इस तरीके से, पेज का कोई भी पिछला एलिमेंट, पेज या चुना गया टेक्स्ट हट जाता है. इसलिए, मौजूदा पेज पर इस तरीके का इस्तेमाल करके, पेज पर चुने गए किसी भी विकल्प से चुने हुए का निशान हटाया जा सकता है. उदाहरण के लिए:

slides/selection/selection.gs

GitHub पर देखें

// 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
//

पेज एलिमेंट चुनना

किसी पेज में पेज एलिमेंट चुनने के लिए, PageElement.select() तरीके का इस्तेमाल करें. इससे, पहले से चुने गए पेज एलिमेंट से भी चुने हुए का निशान हट जाएगा.

select() और select(true) के तरीके एक जैसे हैं.

उदाहरण के लिए:

slides/selection/selection.gs

GitHub पर देखें

  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
//

एक से ज़्यादा पेज एलिमेंट चुनना

चुने गए पेज एलिमेंट में और एलिमेंट जोड़ने के लिए, PageElement.select(false) तरीके का इस्तेमाल करें. सभी पेज एलिमेंट, मौजूदा पेज में होने चाहिए.

slides/selection/selection.gs

GitHub पर देखना

  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
//

चुनाव में बदलाव किया जा रहा है

आपकी स्क्रिप्ट में जो बदलाव किए जाते हैं वे मौजूदा चुनाव को बदल सकते हैं. इससे, बदलाव की वजह से चुने गए बदलाव में बदलाव हो सकता है. उदाहरण के लिए:

1. मान लीजिए कि आपने दो आकार A और B चुने हैं.
2. इसके बाद, आपकी स्क्रिप्ट आकार A को हटा देती है.
3. इस वजह से, चुने गए आइटम में बदलाव किया जाता है, ताकि सिर्फ़ आकार B चुना जा सके.

नीचे दिए गए उदाहरण में दिखाया गया है कि चुने गए पेज एलिमेंट में बदलाव करके, चुने गए एलिमेंट को कैसे बदला जा सकता है.

slides/selection/selection.gs

GitHub पर देखना

  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]
//

टेक्स्ट चुनना

किसी आकार या टेबल सेल में मौजूद टेक्स्ट को चुनने के लिए, TextRange.select() तरीके का इस्तेमाल किया जा सकता है. अगर टेक्स्ट किसी आकार में है, तो वह आकार भी चुना जाता है. अगर टेक्स्ट किसी टेबल सेल में है, तो उस टेबल सेल और उससे जुड़ी टेबल, दोनों को चुना जाता है.

इससे पैरंट पेज को भी मौजूदा पेज के तौर पर सेट किया जाता है.

किसी आकार में रेंज चुनना

नीचे दिए गए उदाहरण में, किसी आकार में शामिल टेक्स्ट में रेंज चुनने का तरीका बताया गया है.

slides/selection/selection.gs

GitHub पर देखें

  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
//

किसी आकार में कर्सर से चुना गया हिस्सा

नीचे दिए गए उदाहरण में, किसी आकार में मौजूद टेक्स्ट में कर्सर से टेक्स्ट चुनने का तरीका बताया गया है.

slides/selection/selection.gs

GitHub पर देखना

  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
//

टेबल सेल में रेंज चुनना

नीचे दिए गए उदाहरण में, टेबल सेल में मौजूद टेक्स्ट में रेंज चुनने का तरीका बताया गया है.

Slides/selection/selection.gs

GitHub पर देखना

  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 में कर्सर से चुनना

नीचे दिए गए उदाहरण में, टेबल सेल में मौजूद टेक्स्ट में कर्सर चुनने का तरीका बताया गया है.

slides/selection/selection.gs

GitHub पर देखना

  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
//

टेक्स्ट में किए गए बदलावों की मदद से, उसके हिसाब से टेक्स्ट में बदलाव करना

नीचे दिए गए उदाहरण में बताया गया है कि चुने गए टेक्स्ट में बदलाव करके, चुने गए हिस्से को कैसे बदला जा सकता है.

slides/selection/selection.gs

GitHub पर देखें

  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
//

चुने हुए का निशान हटाया जा रहा है

टेक्स्ट या पेज एलिमेंट से चुने हुए का निशान हटाने के लिए, कोई खास तरीका नहीं है. हालांकि, Page.selectAsCurrentPage() या pageElement.select() तरीकों का इस्तेमाल करके भी यह नतीजा मिल सकता है.

कोई मौजूदा पेज चुनें

नीचे दिए गए उदाहरण में, किसी पेज को मौजूदा पेज के तौर पर सेट करके, उस पर चुने गए किसी भी विकल्प को हटाने का तरीका बताया गया है.

slides/selection/selection.gs

GitHub पर देखें

// 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();

कोई पेज एलिमेंट चुनना

नीचे दिए गए उदाहरण में, किसी पेज के किसी एलिमेंट को चुनकर, पेज पर चुने गए किसी भी मौजूदा विकल्प को हटाने का तरीका बताया गया है. इससे, चुने गए अन्य सभी आइटम हट जाते हैं.

slides/selection/selection.gs

GitHub पर देखना

// 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();