Class Table

टेबल

टेबल दिखाने वाला एलिमेंट. Table में सिर्फ़ TableRow एलिमेंट हो सकते हैं. दस्तावेज़ की बनावट के बारे में ज़्यादा जानने के लिए, Google Docs की सीमा बढ़ाने की गाइड देखें.

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

var body = DocumentApp.getActiveDocument().getBody();

// Create a two-dimensional array containing the cell contents.
var cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2']
];

// Build a table from the array.
body.appendTable(cells);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
appendTableRow()TableRowनया TableRow बनाता और जोड़ता है.
appendTableRow(tableRow)TableRowदिए गए TableRow को जोड़ता है.
clear()Tableएलिमेंट के कॉन्टेंट को हटाता है.
copy()Tableमौजूदा एलिमेंट की डिटैच की गई और डीप कॉपी दिखाता है.
editAsText()Textबदलाव करने के लिए, मौजूदा एलिमेंट का Text वर्शन लेता है.
findElement(elementType)RangeElementकिसी खास टाइप के डिसेंडेंट के लिए, एलिमेंट के कॉन्टेंट को खोजता है.
findElement(elementType, from)RangeElementबताए गए RangeElement से शुरू करते हुए, किसी खास टाइप के डिसेंडेंट के लिए, एलिमेंट का कॉन्टेंट खोजता है.
findText(searchPattern)RangeElementरेगुलर एक्सप्रेशन का इस्तेमाल करके, तय टेक्स्ट पैटर्न के लिए एलिमेंट की सामग्री खोजता है.
findText(searchPattern, from)RangeElementदिए गए खोज के नतीजे से शुरू करते हुए, खास टेक्स्ट पैटर्न के लिए एलिमेंट का कॉन्टेंट खोजता है.
getAttributes()Objectएलिमेंट के एट्रिब्यूट वापस लाता है.
getBorderColor()Stringबॉर्डर का रंग लेता है.
getBorderWidth()Numberबॉर्डर की चौड़ाई को पॉइंट में लाता है.
getCell(rowIndex, cellIndex)TableCellतय पंक्ति और सेल इंडेक्स पर TableCell को फिर से लाता है.
getChild(childIndex)Elementतय किए गए चाइल्ड इंडेक्स में चाइल्ड एलिमेंट वापस लाता है.
getChildIndex(child)Integerदिए गए चाइल्ड एलिमेंट के लिए चाइल्ड इंडेक्स फिर से हासिल करता है.
getColumnWidth(columnIndex)Numberटेबल के चुने गए कॉलम की चौड़ाई को पॉइंट में दिखाता है.
getLinkUrl()Stringलिंक का यूआरएल वापस लाता है.
getNextSibling()Elementएलिमेंट का अगला सिबलिंग एलिमेंट वापस लाता है.
getNumChildren()Integerबच्चों की संख्या फिर से हासिल करता है.
getNumRows()IntegerTableRows की संख्या फिर से हासिल करता है.
getParent()ContainerElementएलिमेंट के पैरंट एलिमेंट को वापस लाता है.
getPreviousSibling()Elementएलिमेंट के पिछले सिबलिंग एलिमेंट को फिर से लाता है.
getRow(rowIndex)TableRowतय की गई पंक्ति के इंडेक्स पर TableRow को फिर से लाता है.
getText()Stringएलिमेंट के कॉन्टेंट को टेक्स्ट स्ट्रिंग के तौर पर वापस लाता है.
getTextAlignment()TextAlignmentटेक्स्ट अलाइनमेंट पाता है.
getType()ElementTypeएलिमेंट के ElementType को फिर से लाता है.
insertTableRow(childIndex)TableRowतय किए गए इंडेक्स में नया TableRow बनाता और डालें.
insertTableRow(childIndex, tableRow)TableRowदिए गए TableRow को तय इंडेक्स में इंसर्ट करता है.
isAtDocumentEnd()Booleanइससे पता चलता है कि एलिमेंट, Document के आखिर में है या नहीं.
removeChild(child)Tableचुने गए चाइल्ड एलिमेंट को हटाता है.
removeFromParent()Tableइसके पैरंट से एलिमेंट हटा देता है.
removeRow(rowIndex)TableRowतय की गई पंक्ति के इंडेक्स से TableRow को हटाता है.
replaceText(searchPattern, replacement)Elementरेगुलर एक्सप्रेशन का इस्तेमाल करके, दिए गए टेक्स्ट पैटर्न को किसी खास रिप्लेसमेंट स्ट्रिंग से बदलता है.
setAttributes(attributes)Tableएलिमेंट के एट्रिब्यूट सेट करता है.
setBorderColor(color)Tableबॉर्डर का रंग सेट करता है.
setBorderWidth(width)Tableबॉर्डर की चौड़ाई को पॉइंट में सेट करता है.
setColumnWidth(columnIndex, width)Tableतय किए गए कॉलम की चौड़ाई को पॉइंट में सेट करता है.
setLinkUrl(url)Tableलिंक का यूआरएल सेट करता है.
setTextAlignment(textAlignment)Tableटेक्स्ट अलाइनमेंट सेट करता है.

ज़्यादा जानकारी के साथ दस्तावेज़

appendTableRow()

नया TableRow बनाता और जोड़ता है.

रिटर्न

TableRow — टेबल की नई पंक्ति में शामिल एलिमेंट

अनुमति देना

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

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

appendTableRow(tableRow)

दिए गए TableRow को जोड़ता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table in the document and copies the second row.
const table = body.getTables()[0];
const row = table.getChild(1).copy();

// Adds the copied row to the bottom of the table.
const tableRow = table.appendTableRow(row);

पैरामीटर

नामTypeब्यौरा
tableRowTableRowजोड़ने के लिए टेबल की पंक्ति.

रिटर्न

TableRow — जोड़ी गई टेबल में मौजूद पंक्ति का एलिमेंट.

अनुमति देना

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

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

clear()

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

रिटर्न

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


copy()

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

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

रिटर्न

Table — नई कॉपी.

अनुमति देना

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

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

editAsText()

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

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

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

var body = DocumentApp.getActiveDocument().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 — मौजूदा एलिमेंट का टेक्स्ट वर्शन


findElement(elementType)

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

पैरामीटर

नामTypeब्यौरा
elementTypeElementTypeखोजने के लिए एलिमेंट का टाइप

रिटर्न

RangeElement — ऐसा खोज नतीजा जो खोज के नतीजे की जगह को दिखाता है

अनुमति देना

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

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

findElement(elementType, from)

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

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

पैरामीटर

नामTypeब्यौरा
elementTypeElementTypeखोजने के लिए एलिमेंट का टाइप
fromRangeElementइससे खोज करने के लिए खोज नतीजा

रिटर्न

RangeElement — ऐसा खोज नतीजा जो सर्च एलिमेंट की अगली पोज़िशन के बारे में बताता है

अनुमति देना

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

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

findText(searchPattern)

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

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

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

पैरामीटर

नामTypeब्यौरा
searchPatternStringखोजने के लिए पैटर्न

रिटर्न

RangeElement — ऐसा खोज नतीजा जो खोज के टेक्स्ट की जगह दिखाता है या मेल न खाने पर, शून्य होता है

अनुमति देना

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

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

findText(searchPattern, from)

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

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

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

पैरामीटर

नामTypeब्यौरा
searchPatternStringखोजने के लिए पैटर्न
fromRangeElementइससे खोज करने के लिए खोज नतीजा

रिटर्न

RangeElement — ऐसा खोज नतीजा जो खोज के टेक्स्ट की अगली रैंक दिखाता है या मेल न खाने पर, शून्य होता है

अनुमति देना

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

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

getAttributes()

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

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

var body = DocumentApp.getActiveDocument().getBody();

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

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

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

रिटर्न

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

अनुमति देना

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

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

getBorderColor()

बॉर्डर का रंग लेता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Sets the border color of the first table.
table.setBorderColor('#00FF00');

// Logs the border color of the first table to the console.
console.log(table.getBorderColor());

रिटर्न

String — बॉर्डर का रंग, जिसे सीएसएस नोटेशन में फ़ॉर्मैट किया गया है (जैसे कि '#ffffff').

अनुमति देना

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

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

getBorderWidth()

बॉर्डर की चौड़ाई को पॉइंट में लाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Sets the border width of the first table.
table.setBorderWidth(20);

// Logs the border width of the first table.
console.log(table.getBorderWidth());

रिटर्न

Number — बॉर्डर की चौड़ाई, पॉइंट में.

अनुमति देना

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

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

getCell(rowIndex, cellIndex)

तय पंक्ति और सेल इंडेक्स पर TableCell को फिर से लाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Gets the cell of the table's third row and second column.
const cell = table.getCell(2, 1);

// Logs the cell text to the console.
console.log(cell.getText());

पैरामीटर

नामTypeब्यौरा
rowIndexIntegerउस पंक्ति का इंडेक्स जिसमें मौजूद सेल को वापस लाना है.
cellIndexIntegerवापस पाने के लिए सेल का इंडेक्स.

रिटर्न

TableCell — टेबल सेल.

अनुमति देना

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

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

getChild(childIndex)

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

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
var 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.");
}

पैरामीटर

नामTypeब्यौरा
childIndexIntegerवापस लाने के लिए चाइल्ड एलिमेंट का इंडेक्स

रिटर्न

Element — तय किए गए इंडेक्स में चाइल्ड एलिमेंट

अनुमति देना

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

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

getChildIndex(child)

दिए गए चाइल्ड एलिमेंट के लिए चाइल्ड इंडेक्स फिर से हासिल करता है.

पैरामीटर

नामTypeब्यौरा
childElementवह चाइल्ड एलिमेंट जिसके लिए इंडेक्स को फिर से पाना है

रिटर्न

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

अनुमति देना

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

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

getColumnWidth(columnIndex)

टेबल के चुने गए कॉलम की चौड़ाई को पॉइंट में दिखाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Sets the width of the second column to 100 points.
const columnWidth = table.setColumnWidth(1, 100);

// Gets the width of the second column and logs it to the console.
console.log(columnWidth.getColumnWidth(1));

पैरामीटर

नामTypeब्यौरा
columnIndexIntegerकॉलम का इंडेक्स.

रिटर्न

Number — कॉलम की चौड़ाई, पॉइंट में.

अनुमति देना

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

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

getLinkUrl()

लिंक का यूआरएल वापस लाता है.

रिटर्न

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

अनुमति देना

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

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

getNextSibling()

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

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

रिटर्न

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

अनुमति देना

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

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

getNumChildren()

बच्चों की संख्या फिर से हासिल करता है.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Log the number of elements in the document.
Logger.log("There are " + body.getNumChildren() +
    " elements in the document body.");

रिटर्न

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

अनुमति देना

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

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

getNumRows()

TableRows की संख्या फिर से हासिल करता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Logs the number of rows of the first table to the console.
console.log(table.getNumRows());

रिटर्न

Integer — टेबल की पंक्तियों की संख्या.

अनुमति देना

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

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

getParent()

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

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

रिटर्न

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

अनुमति देना

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

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

getPreviousSibling()

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

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

रिटर्न

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

अनुमति देना

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

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

getRow(rowIndex)

तय की गई पंक्ति के इंडेक्स पर TableRow को फिर से लाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table and logs the text of first row to the console.
const table = body.getTables()[0];
console.log(table.getRow(0).getText());

पैरामीटर

नामTypeब्यौरा
rowIndexIntegerफिर से हासिल की जाने वाली पंक्ति का इंडेक्स.

रिटर्न

TableRow — टेबल की पंक्ति.

अनुमति देना

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

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

getText()

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

रिटर्न

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

अनुमति देना

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

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

getTextAlignment()

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

रिटर्न

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

अनुमति देना

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

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

getType()

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

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

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document body.

var 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

insertTableRow(childIndex)

तय किए गए इंडेक्स में नया TableRow बनाता और डालें.

पैरामीटर

नामTypeब्यौरा
childIndexIntegerवह इंडेक्स जिस पर एलिमेंट को डालना है

रिटर्न

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

अनुमति देना

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

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

insertTableRow(childIndex, tableRow)

दिए गए TableRow को तय इंडेक्स में इंसर्ट करता है.

पैरामीटर

नामTypeब्यौरा
childIndexIntegerवह इंडेक्स जिस पर एलिमेंट को डालना है
tableRowTableRowवह टेबल पंक्ति डालें जिसे शामिल करना है

रिटर्न

TableRow — शामिल की गई टेबल की पंक्ति में शामिल एलिमेंट

अनुमति देना

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

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

isAtDocumentEnd()

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

रिटर्न

Boolean — एलिमेंट, दस्तावेज़ के आखिर में है या नहीं.

अनुमति देना

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

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

removeChild(child)

चुने गए चाइल्ड एलिमेंट को हटाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Finds the first table row and removes it.
const element = table.findElement(DocumentApp.ElementType.TABLE_ROW);
table.removeChild(element.getElement());

पैरामीटर

नामTypeब्यौरा
childElementहटाया जाने वाला चाइल्ड एलिमेंट.

रिटर्न

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

अनुमति देना

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

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

removeFromParent()

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

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

रिटर्न

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

अनुमति देना

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

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

removeRow(rowIndex)

तय की गई पंक्ति के इंडेक्स से TableRow को हटाता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table and removes its second row.
const table = body.getTables()[0];
table.removeRow(1);

पैरामीटर

नामTypeब्यौरा
rowIndexIntegerहटाई जाने वाली पंक्ति का इंडेक्स.

रिटर्न

TableRow — हटाई गई पंक्ति.

अनुमति देना

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

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

replaceText(searchPattern, replacement)

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

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

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

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

var body = DocumentApp.getActiveDocument().getBody();

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

पैरामीटर

नामTypeब्यौरा
searchPatternStringखोज करने के लिए रेगुलर एक्सप्रेशन पैटर्न
replacementStringबदले जाने के लिए इस्तेमाल किया जाने वाला टेक्स्ट

रिटर्न

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

अनुमति देना

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

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

setAttributes(attributes)

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

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

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var 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.
var par = body.appendParagraph('A paragraph with custom style.');

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

पैरामीटर

नामTypeब्यौरा
attributesObjectएलिमेंट के एट्रिब्यूट.

रिटर्न

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

अनुमति देना

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

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

setBorderColor(color)

बॉर्डर का रंग सेट करता है.

// Opens the Docs file by its ID. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('abc123456');

// Gets the document body.
const body = doc.getBody();

// Gets the first table.
const table = body.getTables()[0];

// Sets the border color of the table to green.
table.setBorderColor('#00FF00');

पैरामीटर

नामTypeब्यौरा
colorStringबॉर्डर का रंग, जिसे सीएसएस नोटेशन (जैसे '#ffffff') में फ़ॉर्मैट किया गया हो.

रिटर्न

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

अनुमति देना

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

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

setBorderWidth(width)

बॉर्डर की चौड़ाई को पॉइंट में सेट करता है.

पैरामीटर

नामTypeब्यौरा
widthNumberबॉर्डर की चौड़ाई, पॉइंट में

रिटर्न

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

अनुमति देना

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

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

setColumnWidth(columnIndex, width)

तय किए गए कॉलम की चौड़ाई को पॉइंट में सेट करता है.

पैरामीटर

नामTypeब्यौरा
columnIndexIntegerकॉलम इंडेक्स
widthNumberबॉर्डर की चौड़ाई, पॉइंट में

रिटर्न

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

अनुमति देना

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

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

setLinkUrl(url)

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

पैरामीटर

नामTypeब्यौरा
urlStringलिंक का यूआरएल

रिटर्न

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

अनुमति देना

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

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

setTextAlignment(textAlignment)

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

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

पैरामीटर

नामTypeब्यौरा
textAlignmentTextAlignmentलागू करने के लिए टेक्स्ट अलाइनमेंट का टाइप

रिटर्न

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

अनुमति देना

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

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