หน้านี้ได้รับการแปลโดย Cloud Translation API

Class TableCell

องค์ประกอบที่แสดงถึงเซลล์ในตาราง TableCell จะอยู่ใน TableRow เสมอและอาจมีองค์ประกอบ ListItem, Paragraph หรือ Table สำหรับ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างเอกสาร โปรดดูคำแนะนำในการขยาย Google เอกสาร

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`appendHorizontalRule()`	`HorizontalRule`	สร้างและเพิ่ม `HorizontalRule` ใหม่
`appendImage(image)`	`InlineImage`	สร้างและเพิ่ม `InlineImage` ใหม่จาก Blob ของรูปภาพที่ระบุ
`appendImage(image)`	`InlineImage`	เพิ่ม `InlineImage` ที่ระบุ
`appendListItem(listItem)`	`ListItem`	เพิ่ม `ListItem` ที่ระบุ
`appendListItem(text)`	`ListItem`	สร้างและเพิ่ม `ListItem` ใหม่
`appendParagraph(paragraph)`	`Paragraph`	เพิ่ม `Paragraph` ที่ระบุ
`appendParagraph(text)`	`Paragraph`	สร้างและเพิ่ม `Paragraph` ใหม่
`appendTable()`	`Table`	สร้างและเพิ่ม `Table` ใหม่
`appendTable(cells)`	`Table`	เพิ่ม `Table` ใหม่ซึ่งมีเซลล์ที่ระบุต่อท้าย
`appendTable(table)`	`Table`	เพิ่ม `Table` ที่ระบุ
`clear()`	`TableCell`	ล้างเนื้อหาขององค์ประกอบ
`copy()`	`TableCell`	แสดงผลสำเนาที่แยกส่วนลึกขององค์ประกอบปัจจุบัน
`editAsText()`	`Text`	รับองค์ประกอบปัจจุบันเวอร์ชัน`Text` เพื่อแก้ไข
`findElement(elementType)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบเพื่อหาองค์ประกอบสืบทอดของประเภทที่ระบุ
`findElement(elementType, from)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบเพื่อหาองค์ประกอบสืบทอดของประเภทที่ระบุ โดยเริ่มจาก ระบุ `RangeElement` แล้ว
`findText(searchPattern)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบสำหรับรูปแบบข้อความที่ระบุโดยใช้นิพจน์ทั่วไป
`findText(searchPattern, from)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบสำหรับรูปแบบข้อความที่ระบุ โดยเริ่มต้นจาก ผลการค้นหา
`getAttributes()`	`Object`	ดึงแอตทริบิวต์ขององค์ประกอบ
`getBackgroundColor()`	`String`	เรียกดูสีพื้นหลัง
`getChild(childIndex)`	`Element`	เรียกข้อมูลองค์ประกอบย่อยที่ดัชนีย่อยที่ระบุ
`getChildIndex(child)`	`Integer`	เรียกดัชนีย่อยสำหรับองค์ประกอบย่อยที่ระบุ
`getColSpan()`	`Integer`	ดึงข้อมูลช่วงคอลัมน์ซึ่งเป็นจำนวนคอลัมน์ของเซลล์ในตารางที่ช่วงเซลล์นี้
`getLinkUrl()`	`String`	ดึงข้อมูล URL ของลิงก์
`getNextSibling()`	`Element`	เรียกข้อมูลองค์ประกอบข้างเคียงถัดไปขององค์ประกอบ
`getNumChildren()`	`Integer`	ดึงจำนวนเด็ก
`getPaddingBottom()`	`Number`	ดึงข้อมูลระยะห่างจากขอบด้านล่าง หน่วยเป็นจุด
`getPaddingLeft()`	`Number`	ดึงข้อมูลระยะห่างจากขอบด้านซ้าย หน่วยเป็นจุด
`getPaddingRight()`	`Number`	ดึงข้อมูลระยะห่างจากขอบที่เหมาะสม หน่วยเป็นจุด
`getPaddingTop()`	`Number`	ดึงข้อมูลระยะห่างจากขอบด้านบน ในหน่วยจุด
`getParent()`	`ContainerElement`	เรียกข้อมูลองค์ประกอบหลักขององค์ประกอบ
`getParentRow()`	`TableRow`	เรียกข้อมูล `TableRow` ที่มี `TableCell` ปัจจุบัน
`getParentTable()`	`Table`	เรียกข้อมูล `Table` ที่มี `TableCell` ปัจจุบัน
`getPreviousSibling()`	`Element`	ดึงองค์ประกอบระดับเดียวกันก่อนหน้านี้ขององค์ประกอบ
`getRowSpan()`	`Integer`	ดึงข้อมูลช่วงแถว ซึ่งเป็นจำนวนแถวของเซลล์ในตารางที่ช่วงเซลล์นี้
`getText()`	`String`	เรียกคืนเนื้อหาขององค์ประกอบเป็นสตริงข้อความ
`getTextAlignment()`	`TextAlignment`	ปรับการจัดข้อความ
`getType()`	`ElementType`	เรียกข้อมูล `ElementType` ขององค์ประกอบ
`getVerticalAlignment()`	`VerticalAlignment`	เรียกข้อมูล `VerticalAlignment`
`getWidth()`	`Number`	ดึงข้อมูลความกว้างของคอลัมน์ที่มีเซลล์เป็นจุด
`insertHorizontalRule(childIndex)`	`HorizontalRule`	สร้างและแทรก `HorizontalRule` ใหม่ที่ดัชนีที่ระบุ
`insertImage(childIndex, image)`	`InlineImage`	สร้างและแทรก `InlineImage` จาก Blob รูปภาพที่ระบุที่ ดัชนี
`insertImage(childIndex, image)`	`InlineImage`	แทรก `InlineImage` ที่ระบุที่ดัชนีที่ระบุ
`insertListItem(childIndex, listItem)`	`ListItem`	แทรก `ListItem` ที่ระบุที่ดัชนีที่ระบุ
`insertListItem(childIndex, text)`	`ListItem`	สร้างและแทรก `ListItem` ใหม่ที่ดัชนีที่ระบุ
`insertParagraph(childIndex, paragraph)`	`Paragraph`	แทรก `Paragraph` ที่ระบุที่ดัชนีที่ระบุ
`insertParagraph(childIndex, text)`	`Paragraph`	สร้างและแทรก `Paragraph` ใหม่ที่ดัชนีที่ระบุ
`insertTable(childIndex)`	`Table`	สร้างและแทรก `Table` ใหม่ที่ดัชนีที่ระบุ
`insertTable(childIndex, cells)`	`Table`	สร้างและแทรก `Table` ใหม่ซึ่งมีเซลล์ที่ระบุที่ดัชนีที่ระบุ
`insertTable(childIndex, table)`	`Table`	แทรก `Table` ที่ระบุที่ดัชนีที่ระบุ
`isAtDocumentEnd()`	`Boolean`	กำหนดว่าองค์ประกอบอยู่ที่ส่วนท้ายของ `Document` หรือไม่
`merge()`	`TableCell`	ผสานองค์ประกอบกับรายการข้างเคียงที่อยู่ก่อนหน้าประเภทเดียวกัน
`removeChild(child)`	`TableCell`	นำองค์ประกอบย่อยที่ระบุออก
`removeFromParent()`	`TableCell`	นำองค์ประกอบออกจากระดับบนสุด
`replaceText(searchPattern, replacement)`	`Element`	แทนที่ทุกรายการของรูปแบบข้อความที่ระบุด้วยสตริงการแทนที่ที่กำหนด โดยใช้ข้อความปกติ นิพจน์
`setAttributes(attributes)`	`TableCell`	ตั้งค่าแอตทริบิวต์ขององค์ประกอบ
`setBackgroundColor(color)`	`TableCell`	ตั้งค่าสีพื้นหลัง
`setLinkUrl(url)`	`TableCell`	ตั้งค่า URL ของลิงก์
`setPaddingBottom(paddingBottom)`	`TableCell`	ตั้งค่าระยะห่างจากขอบด้านล่าง หน่วยเป็นจุด
`setPaddingLeft(paddingLeft)`	`TableCell`	ตั้งค่าระยะห่างจากขอบด้านซ้าย หน่วยเป็นจุด
`setPaddingRight(paddingRight)`	`TableCell`	ตั้งค่าระยะห่างจากขอบที่เหมาะสมเป็นจุด
`setPaddingTop(paddingTop)`	`TableCell`	ตั้งค่าระยะห่างจากขอบด้านบน หน่วยเป็นจุด
`setText(text)`	`TableCell`	ตั้งค่าเนื้อหาเป็นข้อความธรรมดา
`setTextAlignment(textAlignment)`	`TableCell`	ตั้งค่าการจัดข้อความ
`setVerticalAlignment(alignment)`	`TableCell`	ตั้งค่าการจัดข้อความแนวตั้ง
`setWidth(width)`	`TableCell`	ตั้งค่าความกว้างของคอลัมน์ที่มีเซลล์ปัจจุบันเป็นจุด

เอกสารโดยละเอียด

`appendHorizontalRule()`

สร้างและเพิ่ม HorizontalRule ใหม่

HorizontalRule จะอยู่ใน Paragraph ใหม่

รีเทิร์น

HorizontalRule — กฎแนวนอนใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

`appendImage(image)`

สร้างและเพิ่ม InlineImage ใหม่จาก Blob ของรูปภาพที่ระบุ

InlineImage จะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`image`	`BlobSource`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพใหม่

การให้สิทธิ์

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

`appendImage(image)`

เพิ่ม InlineImage ที่ระบุ

InlineImage จะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`image`	`InlineImage`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพที่ต่อท้าย

การให้สิทธิ์

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

`appendListItem(listItem)`

เพิ่ม ListItem ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`listItem`	`ListItem`	รายการที่จะเพิ่มต่อท้าย

รีเทิร์น

ListItem — ข้อมูลในรายการที่ต่อท้าย

การให้สิทธิ์

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

`appendListItem(text)`

สร้างและเพิ่ม ListItem ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาข้อความ

รีเทิร์น

ListItem — รายการใหม่

การให้สิทธิ์

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

`appendParagraph(paragraph)`

เพิ่ม Paragraph ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paragraph`	`Paragraph`	ย่อหน้าที่จะต่อท้าย

รีเทิร์น

Paragraph — ย่อหน้าที่ต่อท้าย

การให้สิทธิ์

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

`appendParagraph(text)`

สร้างและเพิ่ม Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาข้อความ

รีเทิร์น

Paragraph — ย่อหน้าใหม่

การให้สิทธิ์

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

`appendTable()`

สร้างและเพิ่ม Table ใหม่

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`appendTable(cells)`

เพิ่ม Table ใหม่ซึ่งมีเซลล์ที่ระบุต่อท้าย

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`cells`	`String[][]`	เนื้อหาข้อความของเซลล์ตารางที่จะเพิ่มไปยังตารางใหม่

รีเทิร์น

Table — ตารางที่ต่อท้าย

การให้สิทธิ์

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

`appendTable(table)`

เพิ่ม Table ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`table`	`Table`	ตารางที่จะต่อท้าย

รีเทิร์น

Table — ตารางที่ต่อท้าย

การให้สิทธิ์

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

`clear()`

ล้างเนื้อหาขององค์ประกอบ

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

`copy()`

แสดงผลสำเนาที่แยกส่วนลึกขององค์ประกอบปัจจุบัน

ระบบจะคัดลอกองค์ประกอบย่อยที่อยู่ในองค์ประกอบดังกล่าวด้วย องค์ประกอบใหม่ไม่มีองค์ประกอบ หลัก

รีเทิร์น

TableCell — สำเนาใหม่

การให้สิทธิ์

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

`editAsText()`

รับองค์ประกอบปัจจุบันเวอร์ชันText เพื่อแก้ไข

ใช้ editAsText เพื่อจัดการเนื้อหาองค์ประกอบแบบ Rich Text โหมด editAsText จะไม่สนใจองค์ประกอบที่ไม่ใช่ข้อความ (เช่น InlineImage และ HorizontalRule)

ระบบจะนำองค์ประกอบย่อยที่อยู่แบบเต็มในช่วงข้อความที่ถูกลบออกจากองค์ประกอบดังกล่าว

var 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 — เวอร์ชันข้อความขององค์ประกอบปัจจุบัน

`findElement(elementType)`

ค้นหาเนื้อหาขององค์ประกอบเพื่อหาองค์ประกอบสืบทอดของประเภทที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`elementType`	`ElementType`	ประเภทขององค์ประกอบที่จะค้นหา

รีเทิร์น

RangeElement — ผลการค้นหาที่ระบุตำแหน่งขององค์ประกอบการค้นหา

การให้สิทธิ์

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

`findElement(elementType, from)`

ค้นหาเนื้อหาขององค์ประกอบเพื่อหาองค์ประกอบสืบทอดของประเภทที่ระบุ โดยเริ่มจาก ระบุ RangeElement แล้ว

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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;
  }
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`elementType`	`ElementType`	ประเภทขององค์ประกอบที่จะค้นหา
`from`	`RangeElement`	ผลการค้นหาที่จะค้นหา

รีเทิร์น

RangeElement — ผลการค้นหาที่ระบุตำแหน่งถัดไปขององค์ประกอบการค้นหา

การให้สิทธิ์

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

`findText(searchPattern)`

ค้นหาเนื้อหาขององค์ประกอบสำหรับรูปแบบข้อความที่ระบุโดยใช้นิพจน์ทั่วไป

ระบบยังไม่รองรับฟีเจอร์นิพจน์ทั่วไปของ JavaScript บางส่วนอย่างสมบูรณ์ เช่น แคปเจอร์กรุ๊ปและตัวปรับแต่งโหมด

รูปแบบนิพจน์ทั่วไปที่ระบุจะถูกจับคู่กับบล็อกข้อความแต่ละบล็อกแยกกัน ที่มีอยู่ในองค์ประกอบปัจจุบัน

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบที่จะค้นหา

รีเทิร์น

RangeElement — ผลการค้นหาที่ระบุตำแหน่งของข้อความค้นหา หรือไม่มีข้อมูล หากไม่มี การจับคู่ที่ตรงกัน

การให้สิทธิ์

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

`findText(searchPattern, from)`

ค้นหาเนื้อหาขององค์ประกอบสำหรับรูปแบบข้อความที่ระบุ โดยเริ่มต้นจาก ผลการค้นหา

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบที่จะค้นหา
`from`	`RangeElement`	ผลการค้นหาที่จะค้นหาจาก

รีเทิร์น

RangeElement — ผลการค้นหาที่ระบุตำแหน่งถัดไปของข้อความค้นหา หรือไม่มีข้อมูลหากไม่มี การจับคู่ที่ตรงกัน

การให้สิทธิ์

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

`getAttributes()`

ดึงแอตทริบิวต์ขององค์ประกอบ

ผลลัพธ์คือออบเจ็กต์ที่มีพร็อพเพอร์ตี้สำหรับแอตทริบิวต์ขององค์ประกอบที่ถูกต้องแต่ละรายการ โดยที่แต่ละรายการ ชื่อพร็อพเพอร์ตี้สอดคล้องกับรายการในการแจกแจง DocumentApp.Attribute

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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

`getBackgroundColor()`

เรียกดูสีพื้นหลัง

รีเทิร์น

String — สีพื้นหลัง ซึ่งอยู่ในรูปแบบ CSS (เช่น '#ffffff')

การให้สิทธิ์

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

`getChild(childIndex)`

เรียกข้อมูลองค์ประกอบย่อยที่ดัชนีย่อยที่ระบุ

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีขององค์ประกอบย่อยที่จะดึงข้อมูล

รีเทิร์น

Element — องค์ประกอบย่อยในดัชนีที่ระบุ

การให้สิทธิ์

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

`getChildIndex(child)`

เรียกดัชนีย่อยสำหรับองค์ประกอบย่อยที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Element`	องค์ประกอบย่อยที่จะดึงข้อมูลดัชนี

รีเทิร์น

Integer — ดัชนีย่อย

การให้สิทธิ์

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

`getColSpan()`

ดึงข้อมูลช่วงคอลัมน์ซึ่งเป็นจำนวนคอลัมน์ของเซลล์ในตารางที่ช่วงเซลล์นี้ เซลล์ที่ไม่ได้ผสานจะมีสแปนของคอลัมน์อยู่ที่ 1

รีเทิร์น

Integer — ช่วงคอลัมน์หรือ 0 สำหรับเซลล์ที่มีการผสานด้วยเซลล์อื่น

การให้สิทธิ์

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

`getLinkUrl()`

ดึงข้อมูล URL ของลิงก์

รีเทิร์น

String — URL ของลิงก์ หรือค่าว่างหากองค์ประกอบมีค่าหลายค่าสำหรับแอตทริบิวต์นี้

การให้สิทธิ์

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()`

ดึงจำนวนเด็ก

var 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

`getPaddingBottom()`

ดึงข้อมูลระยะห่างจากขอบด้านล่าง หน่วยเป็นจุด

รีเทิร์น

Number — ระยะห่างจากขอบด้านล่าง เป็นจุด

การให้สิทธิ์

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

`getPaddingLeft()`

ดึงข้อมูลระยะห่างจากขอบด้านซ้าย หน่วยเป็นจุด

รีเทิร์น

Number — ระยะห่างจากขอบด้านซ้าย เป็นจุด

การให้สิทธิ์

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

`getPaddingRight()`

ดึงข้อมูลระยะห่างจากขอบที่เหมาะสม หน่วยเป็นจุด

รีเทิร์น

Number — ระยะห่างจากขอบที่เหมาะสม เป็นจุด

การให้สิทธิ์

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

`getPaddingTop()`

ดึงข้อมูลระยะห่างจากขอบด้านบน ในหน่วยจุด

รีเทิร์น

Number — ระยะห่างจากขอบด้านบน เป็นจุด

การให้สิทธิ์

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

`getParentRow()`

เรียกข้อมูล TableRow ที่มี TableCell ปัจจุบัน

รีเทิร์น

TableRow — แถวของตารางที่มีเซลล์ปัจจุบัน

การให้สิทธิ์

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

`getParentTable()`

เรียกข้อมูล Table ที่มี TableCell ปัจจุบัน

รีเทิร์น

Table — ตารางที่มีเซลล์ปัจจุบัน

การให้สิทธิ์

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

`getRowSpan()`

ดึงข้อมูลช่วงแถว ซึ่งเป็นจำนวนแถวของเซลล์ในตารางที่ช่วงเซลล์นี้ ไม่ได้ผสานรวม เซลล์มีช่วงของแถวที่ 1

รีเทิร์น

Integer — ช่วงแถวหรือ 0 สำหรับเซลล์ที่มีการผสานด้วยเซลล์อื่น

การให้สิทธิ์

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 doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's 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

`getVerticalAlignment()`

เรียกข้อมูล VerticalAlignment

รีเทิร์น

VerticalAlignment — การจัดข้อความแนวตั้ง

การให้สิทธิ์

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

`getWidth()`

ดึงข้อมูลความกว้างของคอลัมน์ที่มีเซลล์เป็นจุด

รีเทิร์น

Number — ความกว้างของคอลัมน์ หน่วยเป็นจุด

การให้สิทธิ์

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

`insertHorizontalRule(childIndex)`

สร้างและแทรก HorizontalRule ใหม่ที่ดัชนีที่ระบุ

กฎแนวนอนจะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ

รีเทิร์น

HorizontalRule — กฎแนวนอนใหม่

การให้สิทธิ์

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

`insertImage(childIndex, image)`

สร้างและแทรก InlineImage จาก Blob รูปภาพที่ระบุที่ ดัชนี

รูปภาพจะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`image`	`BlobSource`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพแทรกในบรรทัด

การให้สิทธิ์

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

`insertImage(childIndex, image)`

แทรก InlineImage ที่ระบุที่ดัชนีที่ระบุ

รูปภาพจะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`image`	`InlineImage`	รูปภาพที่จะแทรก

รีเทิร์น

InlineImage — รูปภาพแทรกในบรรทัด

การให้สิทธิ์

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

`insertListItem(childIndex, listItem)`

แทรก ListItem ที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`listItem`	`ListItem`	รายการที่จะแทรก

รีเทิร์น

ListItem — แทรกรายการใหม่แล้ว

การให้สิทธิ์

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

`insertListItem(childIndex, text)`

สร้างและแทรก ListItem ใหม่ที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`text`	`String`	เนื้อหาข้อความ

รีเทิร์น

ListItem — รายการใหม่

การให้สิทธิ์

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

`insertParagraph(childIndex, paragraph)`

แทรก Paragraph ที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`paragraph`	`Paragraph`	ย่อหน้าที่จะแทรก

รีเทิร์น

Paragraph — ย่อหน้าที่แทรก

การให้สิทธิ์

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

`insertParagraph(childIndex, text)`

สร้างและแทรก Paragraph ใหม่ที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`text`	`String`	เนื้อหาข้อความ

รีเทิร์น

Paragraph — ย่อหน้าใหม่

การให้สิทธิ์

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

`insertTable(childIndex)`

สร้างและแทรก Table ใหม่ที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`insertTable(childIndex, cells)`

สร้างและแทรก Table ใหม่ซึ่งมีเซลล์ที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`cells`	`String[][]`	เนื้อหาข้อความของเซลล์ตารางที่จะเพิ่มไปยังตารางใหม่

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`insertTable(childIndex, table)`

แทรก Table ที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`table`	`Table`	ตารางที่จะแทรก

รีเทิร์น

Table — ตารางที่แทรก

การให้สิทธิ์

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

`merge()`

ผสานองค์ประกอบกับรายการข้างเคียงที่อยู่ก่อนหน้าประเภทเดียวกัน

รวมได้เฉพาะองค์ประกอบของ ElementType เดียวกันเท่านั้น องค์ประกอบย่อยใดๆ ที่มีอยู่ใน ระบบจะย้ายองค์ประกอบปัจจุบันไปยังองค์ประกอบระดับเดียวกันที่อยู่ก่อนหน้า

องค์ประกอบปัจจุบันจะถูกนำออกจากเอกสาร

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's 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.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

รีเทิร์น

TableCell — องค์ประกอบที่ผสานรวม

การให้สิทธิ์

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

`removeChild(child)`

นำองค์ประกอบย่อยที่ระบุออก

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Element`	องค์ประกอบย่อยที่จะนำออก

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`removeFromParent()`

นำองค์ประกอบออกจากระดับบนสุด

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

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

รีเทิร์น

TableCell — องค์ประกอบที่นำออก

การให้สิทธิ์

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

`replaceText(searchPattern, replacement)`

แทนที่ทุกรายการของรูปแบบข้อความที่ระบุด้วยสตริงการแทนที่ที่กำหนด โดยใช้ข้อความปกติ นิพจน์

ระบบจะส่งรูปแบบการค้นหาเป็นสตริง ไม่ใช่ออบเจ็กต์นิพจน์ทั่วไปของ JavaScript ด้วยเหตุนี้ คุณจึงต้องไม่ใช้เครื่องหมายแบ็กสแลชในรูปแบบนี้

วิธีนี้ใช้เมตริก RE2 ของ Google ตามปกติ ไลบรารีนิพจน์ซึ่งจำกัดไวยากรณ์ที่รองรับ

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบนิพจน์ทั่วไปที่จะค้นหา
`replacement`	`String`	ข้อความที่จะใช้แทนที่

รีเทิร์น

Element — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setAttributes(attributes)`

ตั้งค่าแอตทริบิวต์ขององค์ประกอบ

พารามิเตอร์แอตทริบิวต์ที่ระบุต้องเป็นออบเจ็กต์ที่ชื่อพร็อพเพอร์ตี้แต่ละชื่อเป็นรายการใน การแจงนับ DocumentApp.Attribute และค่าพร็อพเพอร์ตี้แต่ละค่าคือค่าใหม่ ใช้แล้ว

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`attributes`	`Object`	แอตทริบิวต์ขององค์ประกอบ

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setBackgroundColor(color)`

ตั้งค่าสีพื้นหลัง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`String`	สีพื้นหลัง โดยมีรูปแบบเป็น CSS (เช่น `'#ffffff'`)

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setLinkUrl(url)`

ตั้งค่า URL ของลิงก์

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL ของลิงก์

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setPaddingBottom(paddingBottom)`

ตั้งค่าระยะห่างจากขอบด้านล่าง หน่วยเป็นจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paddingBottom`	`Number`	ระยะห่างจากขอบด้านล่างเป็นจุด

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setPaddingLeft(paddingLeft)`

ตั้งค่าระยะห่างจากขอบด้านซ้าย หน่วยเป็นจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paddingLeft`	`Number`	ระยะห่างจากขอบด้านซ้ายเป็นจุด

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setPaddingRight(paddingRight)`

ตั้งค่าระยะห่างจากขอบที่เหมาะสม (เป็นจุด)

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paddingRight`	`Number`	ระยะห่างจากขอบที่เหมาะสมเป็นจุด

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setPaddingTop(paddingTop)`

ตั้งค่าระยะห่างจากขอบด้านบน หน่วยเป็นจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paddingTop`	`Number`	ระยะห่างจากขอบด้านบนเป็นจุด

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setText(text)`

ตั้งค่าเนื้อหาเป็นข้อความธรรมดา

หมายเหตุ: เนื้อหาที่มีอยู่จะถูกล้าง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาที่เป็นข้อความใหม่

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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 in the active tab be superscript.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textAlignment`	`TextAlignment`	ประเภทการจัดข้อความที่จะใช้

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setVerticalAlignment(alignment)`

ตั้งค่าการจัดข้อความแนวตั้ง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignment`	`VerticalAlignment`	การจัดข้อความแนวตั้ง

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setWidth(width)`

ตั้งค่าความกว้างของคอลัมน์ที่มีเซลล์ปัจจุบันเป็นจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`width`	`Number`	ความกว้างของคอลัมน์ เป็นจุด

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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