Class TableOfContents

एलिमेंट का कॉन्टेंट हटा देता है.

वापसी का टिकट

TableOfContents — मौजूदा एलिमेंट.

मौजूदा एलिमेंट की डीप कॉपी दिखाता है.

एलिमेंट में मौजूद सभी चाइल्ड एलिमेंट भी कॉपी हो जाते हैं. नए एलिमेंट का कोई पैरंट नहीं है.

वापसी का टिकट

TableOfContents — नई कॉपी.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

बदलाव करने के लिए, मौजूदा एलिमेंट का Text वर्शन पाता है.

एलिमेंट के कॉन्टेंट को रिच टेक्स्ट के तौर पर मैनिप्युलेट करने के लिए, editAsText का इस्तेमाल करें. editAsText मोड, टेक्स्ट के अलावा अन्य एलिमेंट (जैसे, InlineImage और HorizontalRule) को अनदेखा करता है.

मिटाए गए टेक्स्ट की रेंज में पूरी तरह से शामिल चाइल्ड एलिमेंट, एलिमेंट से हटा दिए जाते हैं.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, 'An editAsText sample.');
body.insertHorizontalRule(0);
body.insertParagraph(0, 'An example.');

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

वापसी का टिकट

Text — मौजूदा एलिमेंट का टेक्स्ट वर्शन

एलिमेंट के कॉन्टेंट में, बताए गए टाइप के डिसेंटेंट को खोजता है.

पैरामीटर

वापसी का टिकट

RangeElement — खोज के नतीजे में, खोज एलिमेंट की रैंकिंग दिखाने वाला एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के कॉन्टेंट में, तय किए गए RangeElement से शुरू होकर, तय किए गए टाइप के डिसेंटेंट को खोजता है.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

पैरामीटर

वापसी का टिकट

RangeElement — खोज के नतीजे में, खोज एलिमेंट की अगली रैंकिंग की जानकारी देने वाला एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

रेगुलर एक्सप्रेशन का इस्तेमाल करके, एलिमेंट के कॉन्टेंट में दिए गए टेक्स्ट पैटर्न को खोजता है.

JavaScript रेगुलर एक्सप्रेशन की कुछ सुविधाएं पूरी तरह काम नहीं करतीं. जैसे, कैप्चर ग्रुप और मोड मॉडिफ़ायर.

दिए गए रेगुलर एक्सप्रेशन पैटर्न का मिलान, मौजूदा एलिमेंट में मौजूद हर टेक्स्ट ब्लॉक से अलग-अलग किया जाता है.

पैरामीटर

वापसी का टिकट

RangeElement — खोज के नतीजे में, खोज के लिए इस्तेमाल हुए टेक्स्ट की पोज़िशन दिखती है. अगर कोई मैच नहीं मिलता है, तो यह वैल्यू शून्य होती है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

किसी खोज के नतीजे से शुरू करके, एलिमेंट के कॉन्टेंट में दिए गए टेक्स्ट पैटर्न को खोजता है.

JavaScript रेगुलर एक्सप्रेशन की कुछ सुविधाएं पूरी तरह काम नहीं करतीं. जैसे, कैप्चर ग्रुप और मोड मॉडिफ़ायर.

दिए गए रेगुलर एक्सप्रेशन पैटर्न का मिलान, मौजूदा एलिमेंट में मौजूद हर टेक्स्ट ब्लॉक से अलग-अलग किया जाता है.

पैरामीटर

वापसी का टिकट

RangeElement — खोज के नतीजे में, खोज के लिए इस्तेमाल हुए टेक्स्ट की अगली पोज़िशन दिखती है. अगर कोई मैच नहीं मिलता है, तो यह वैल्यू शून्य होती है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के एट्रिब्यूट दिखाता है.

इसका नतीजा एक ऑब्जेक्ट होता है, जिसमें हर मान्य एलिमेंट एट्रिब्यूट के लिए एक प्रॉपर्टी होती है. इसमें हर प्रॉपर्टी का नाम, DocumentApp.Attribute एनोटेशन में मौजूद किसी आइटम से मेल खाता है.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

वापसी का टिकट

Object — एलिमेंट के एट्रिब्यूट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

बताए गए चाइल्ड इंडेक्स पर चाइल्ड एलिमेंट को वापस लाता है.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
const firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText('This is the first paragraph.');
}

पैरामीटर

वापसी का टिकट

Element — तय किए गए इंडेक्स पर मौजूद चाइल्ड एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

बताए गए चाइल्ड एलिमेंट के लिए चाइल्ड इंडेक्स को वापस लाता है.

पैरामीटर

वापसी का टिकट

Integer — चाइल्ड इंडेक्स.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

लिंक का यूआरएल दिखाता है.

वापसी का टिकट

String — लिंक का यूआरएल या अगर एलिमेंट में इस एट्रिब्यूट के लिए एक से ज़्यादा वैल्यू हैं, तो शून्य

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के अगले सिबलिंग एलिमेंट को वापस लाता है.

अगले सिबलिंग का पैरंट एक ही होता है और वह मौजूदा एलिमेंट के बाद आता है.

वापसी का टिकट

Element — अगला सिबलिंग एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

बच्चों की संख्या दिखाता है.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);

वापसी का टिकट

Integer — बच्चों की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट का पैरंट एलिमेंट दिखाता है.

पैरंट एलिमेंट में मौजूदा एलिमेंट होता है.

वापसी का टिकट

ContainerElement — पैरंट एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के पिछले सिबलिंग एलिमेंट को वापस लाता है.

पिछले सिबलिंग का पैरंट एक ही है और वह मौजूदा एलिमेंट से पहले आता है.

वापसी का टिकट

Element — सिबलिंग एलिमेंट का पिछला एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के कॉन्टेंट को टेक्स्ट स्ट्रिंग के तौर पर दिखाता है.

वापसी का टिकट

String — टेक्स्ट स्ट्रिंग के तौर पर एलिमेंट का कॉन्टेंट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

टेक्स्ट अलाइनमेंट की जानकारी मिलती है. अलाइनमेंट के लिए ये टाइप उपलब्ध हैं: DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, और DocumentApp.TextAlignment.SUPERSCRIPT.

वापसी का टिकट

TextAlignment — टेक्स्ट अलाइनमेंट का टाइप या null, अगर टेक्स्ट में एक से ज़्यादा तरह के टेक्स्ट अलाइनमेंट हैं या टेक्स्ट अलाइनमेंट कभी सेट नहीं किया गया है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट का ElementType दिखाता है.

किसी एलिमेंट के टाइप का सटीक पता लगाने के लिए, getType() का इस्तेमाल करें.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

वापसी का टिकट

ElementType — एलिमेंट का टाइप.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

यह तय करता है कि एलिमेंट, Document के आखिर में है या नहीं.

वापसी का टिकट

Boolean — एलिमेंट, टैब के आखिर में है या नहीं.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट को उसके पैरंट से हटाता है.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

वापसी का टिकट

TableOfContents — हटाया गया एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

रेगुलर एक्सप्रेशन का इस्तेमाल करके, किसी दिए गए टेक्स्ट पैटर्न की सभी जगहों पर, दी गई रिप्लेसमेंट स्ट्रिंग से बदल देता है.

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

इस तरीके में, Google की RE2 रेगुलर एक्सप्रेशन लाइब्रेरी का इस्तेमाल किया जाता है. इससे, काम करने वाले सिंटैक्स की संख्या सीमित हो जाती है.

दिए गए रेगुलर एक्सप्रेशन पैटर्न का मिलान, मौजूदा एलिमेंट में मौजूद हर टेक्स्ट ब्लॉक से अलग-अलग किया जाता है.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText('^.*Apps ?Script.*$', 'Apps Script');

पैरामीटर

वापसी का टिकट

Element — मौजूदा एलिमेंट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

एलिमेंट के एट्रिब्यूट सेट करता है.

एट्रिब्यूट पैरामीटर, एक ऑब्जेक्ट होना चाहिए. इसमें हर प्रॉपर्टी का नाम, DocumentApp.Attribute एनोटेशन में मौजूद किसी आइटम के तौर पर होना चाहिए. साथ ही, हर प्रॉपर्टी की वैल्यू, लागू की जाने वाली नई वैल्यू होनी चाहिए.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

पैरामीटर

वापसी का टिकट

TableOfContents — मौजूदा एलिमेंट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

लिंक का यूआरएल सेट करता है.

पैरामीटर

वापसी का टिकट

TableOfContents — मौजूदा एलिमेंट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

टेक्स्ट अलाइनमेंट सेट करता है. अलाइनमेंट के लिए ये टाइप उपलब्ध हैं: DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, और DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph in the active tab be superscript.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

पैरामीटर

वापसी का टिकट

TableOfContents — मौजूदा एलिमेंट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents