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

Class Paragraph

องค์ประกอบที่แสดงถึงย่อหน้า Paragraph อาจมีองค์ประกอบ Equation, Footnote, HorizontalRule, InlineDrawing, InlineImage, PageBreak และ Text โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างของเอกสารในคู่มือการขยาย Google เอกสาร

Paragraphs ต้องไม่มีอักขระขึ้นบรรทัดใหม่ อักขระบรรทัดใหม่ ("\n") ถูกแปลงเป็นอักขระขึ้นบรรทัดใหม่ ("\r")

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

// Append a document header paragraph.
var header = body.appendParagraph("A Document");
header.setHeading(DocumentApp.ParagraphHeading.HEADING1);

// Append a section header paragraph.
var section = body.appendParagraph("Section 1");
section.setHeading(DocumentApp.ParagraphHeading.HEADING2);

// Append a regular paragraph.
body.appendParagraph("This is a typical paragraph.");

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`addPositionedImage(image)`	`PositionedImage`	สร้างและแทรก `PositionedImage` ใหม่จาก Blob รูปภาพที่ระบุ
`appendHorizontalRule()`	`HorizontalRule`	สร้างและต่อท้าย `HorizontalRule` ใหม่
`appendInlineImage(image)`	`InlineImage`	สร้างและแนบ `InlineImage` ใหม่จาก BLOB ของรูปภาพที่ระบุ
`appendInlineImage(image)`	`InlineImage`	เพิ่ม `InlineImage` ที่ระบุ
`appendPageBreak()`	`PageBreak`	สร้างและต่อท้าย `PageBreak` ใหม่
`appendPageBreak(pageBreak)`	`PageBreak`	เพิ่ม `PageBreak` ที่ระบุ
`appendText(text)`	`Text`	สร้างและแนบองค์ประกอบ `Text` ใหม่ด้วยเนื้อหาที่ระบุ
`appendText(text)`	`Text`	เพิ่มองค์ประกอบ `Text` ที่ระบุ
`clear()`	`Paragraph`	ล้างเนื้อหาขององค์ประกอบ
`copy()`	`Paragraph`	แสดงผลสําเนาเดี่ยวที่แยกองค์ประกอบปัจจุบัน
`editAsText()`	`Text`	รับองค์ประกอบปัจจุบัน `Text` เวอร์ชันเพื่อแก้ไข
`findElement(elementType)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบจากมากไปหาน้อยของประเภทที่ระบุ
`findElement(elementType, from)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบในองค์ประกอบสืบทอดจากประเภทที่ระบุ โดยเริ่มจาก `RangeElement` ที่ระบุ
`findText(searchPattern)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบในรูปแบบข้อความที่ระบุโดยใช้นิพจน์ทั่วไป
`findText(searchPattern, from)`	`RangeElement`	ค้นหาเนื้อหาขององค์ประกอบสําหรับรูปแบบข้อความที่ระบุ เริ่มจากผลการค้นหาที่กําหนด
`getAlignment()`	`HorizontalAlignment`	เรียกข้อมูล `HorizontalAlignment`
`getAttributes()`	`Object`	ดึงแอตทริบิวต์ของ'
`getChild(childIndex)`	`Element`	เรียกข้อมูลองค์ประกอบย่อยที่ดัชนีย่อยที่ระบุ
`getChildIndex(child)`	`Integer`	เรียกข้อมูลดัชนีย่อยสําหรับองค์ประกอบย่อยที่ระบุ
`getHeading()`	`ParagraphHeading`	เรียกข้อมูล `ParagraphHeading`
`getIndentEnd()`	`Number`	เรียกข้อมูลการเยื้องสิ้นสุดเป็นจุด
`getIndentFirstLine()`	`Number`	เรียกข้อมูลการเยื้องบรรทัดแรกในจุด
`getIndentStart()`	`Number`	เรียกข้อมูลการเยื้องเริ่มต้น
`getLineSpacing()`	`Number`	เรียกข้อมูลช่องว่างระหว่างบรรทัด เป็นจุด
`getLinkUrl()`	`String`	เรียก URL ของลิงก์
`getNextSibling()`	`Element`	เรียกองค์ประกอบข้างเคียงขององค์ประกอบถัดไป
`getNumChildren()`	`Integer`	ดึงข้อมูลจํานวนบุตรหลาน
`getParent()`	`ContainerElement`	เรียกองค์ประกอบหลักขององค์ประกอบ
`getPositionedImage(id)`	`PositionedImage`	รับ `PositionedImage` ตามรหัสของรูปภาพ
`getPositionedImages()`	`PositionedImage[]`	รับออบเจ็กต์ `PositionedImage` ทั้งหมดซึ่งตรึงอยู่กับย่อหน้า
`getPreviousSibling()`	`Element`	เรียกองค์ประกอบระดับก่อนหน้าขององค์ประกอบ'
`getSpacingAfter()`	`Number`	เรียกข้อมูลช่องว่างหลังองค์ประกอบ เป็นจุด
`getSpacingBefore()`	`Number`	เรียกข้อมูลช่องว่างก่อนองค์ประกอบ ในจุด
`getText()`	`String`	เรียกเนื้อหาขององค์ประกอบเป็นสตริงข้อความ
`getTextAlignment()`	`TextAlignment`	รับการจัดข้อความ
`getType()`	`ElementType`	เรียกดูองค์ประกอบ'`ElementType`
`insertHorizontalRule(childIndex)`	`HorizontalRule`	สร้างและแทรก `HorizontalRule` ที่ดัชนีที่ระบุ
`insertInlineImage(childIndex, image)`	`InlineImage`	สร้างและแทรก `InlineImage` ใหม่จาก Blob รูปภาพที่ระบุที่ดัชนีที่ระบุ
`insertInlineImage(childIndex, image)`	`InlineImage`	แทรก `InlineImage` ที่ระบุที่ดัชนีที่ระบุ
`insertPageBreak(childIndex)`	`PageBreak`	สร้างและแทรก `PageBreak` ใหม่ที่ดัชนีที่ระบุ
`insertPageBreak(childIndex, pageBreak)`	`PageBreak`	แทรก `PageBreak` ที่ระบุที่ดัชนีที่ระบุ
`insertText(childIndex, text)`	`Text`	สร้างและแทรกองค์ประกอบของข้อความใหม่ในดัชนีที่ระบุ
`insertText(childIndex, text)`	`Text`	แทรกองค์ประกอบ `Text` ที่ระบุที่ดัชนีที่ระบุ พร้อมด้วยเนื้อหาข้อความที่ระบุ
`isAtDocumentEnd()`	`Boolean`	กําหนดว่าองค์ประกอบอยู่ท้าย `Document` หรือไม่
`isLeftToRight()`	`Boolean`	เรียกข้อมูลการตั้งค่าจากซ้ายไปขวา
`merge()`	`Paragraph`	ผสานองค์ประกอบกับองค์ประกอบข้างเคียงประเภทเดียวกัน
`removeChild(child)`	`Paragraph`	นําองค์ประกอบย่อยที่ระบุออก
`removeFromParent()`	`Paragraph`	นําองค์ประกอบออกจากระดับบนสุด
`removePositionedImage(id)`	`Boolean`	นํา `PositionedImage` ออกตามรหัสของรูปภาพ
`replaceText(searchPattern, replacement)`	`Element`	แทนที่รูปแบบข้อความที่ระบุทั้งหมดด้วยสตริงแทนที่ที่ระบุโดยใช้นิพจน์ปกติ
`setAlignment(alignment)`	`Paragraph`	ตั้งค่า`HorizontalAlignment`
`setAttributes(attributes)`	`Paragraph`	ตั้งค่าแอตทริบิวต์ขององค์ประกอบ
`setHeading(heading)`	`Paragraph`	ตั้งค่า`ParagraphHeading`
`setIndentEnd(indentEnd)`	`Paragraph`	ตั้งค่าการเยื้องท้ายเป็นจุด
`setIndentFirstLine(indentFirstLine)`	`Paragraph`	ตั้งค่าการเยื้องบรรทัดแรกในจุด
`setIndentStart(indentStart)`	`Paragraph`	ตั้งค่าการเยื้องเริ่มต้นในจุด
`setLeftToRight(leftToRight)`	`Paragraph`	กําหนดการตั้งค่าจากซ้ายไปขวา
`setLineSpacing(multiplier)`	`Paragraph`	กําหนดระยะห่างของบรรทัดเป็นปริมาณที่ระบุจํานวนบรรทัดที่จะใช้ในระยะห่าง
`setLinkUrl(url)`	`Paragraph`	ตั้งค่า URL ของลิงก์
`setSpacingAfter(spacingAfter)`	`Paragraph`	กําหนดระยะห่างหลังองค์ประกอบ เป็นจุด
`setSpacingBefore(spacingBefore)`	`Paragraph`	กําหนดช่องว่างก่อนองค์ประกอบ เป็นจุด
`setText(text)`	`void`	ตั้งค่าเนื้อหาของย่อหน้าเป็นข้อความ
`setTextAlignment(textAlignment)`	`Paragraph`	ตั้งค่าการจัดข้อความ

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

`addPositionedImage(image)`

สร้างและแทรก PositionedImage ใหม่จาก Blob รูปภาพที่ระบุ

พารามิเตอร์

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

ไปกลับ

PositionedImage — รูปภาพที่วางตําแหน่งใหม่

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

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

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

`appendHorizontalRule()`

สร้างและต่อท้าย HorizontalRule ใหม่

ไปกลับ

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

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

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

`appendInlineImage(image)`

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

พารามิเตอร์

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

ไปกลับ

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

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

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

`appendInlineImage(image)`

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

พารามิเตอร์

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

ไปกลับ

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

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

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

`appendPageBreak()`

สร้างและต่อท้าย PageBreak ใหม่

หมายเหตุ: PageBreaks อาจไม่มีอยู่ใน TableCells หากองค์ประกอบปัจจุบันอยู่ในเซลล์ของตาราง มีข้อยกเว้น

ไปกลับ

PageBreak — องค์ประกอบตัวแบ่งหน้าใหม่

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

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

`appendPageBreak(pageBreak)`

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`pageBreak`	`PageBreak`	ตัวแบ่งหน้าที่จะต่อท้าย

ไปกลับ

PageBreak — องค์ประกอบตัวแบ่งหน้าซึ่งต่อท้าย

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

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

`appendText(text)`

สร้างและแนบองค์ประกอบ Text ใหม่ด้วยเนื้อหาที่ระบุ

พารามิเตอร์

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

ไปกลับ

Text — องค์ประกอบของข้อความใหม่

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

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

`appendText(text)`

เพิ่มองค์ประกอบ Text ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`Text`	องค์ประกอบข้อความที่จะต่อท้าย

ไปกลับ

Text — องค์ประกอบข้อความที่ต่อท้าย

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

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

`clear()`

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

ไปกลับ

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

`copy()`

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

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

ไปกลับ

Paragraph — สําเนาใหม่

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

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().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 ที่ระบุ

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

พารามิเตอร์

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

ไปกลับ

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

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

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

`findText(searchPattern)`

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

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

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

พารามิเตอร์

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

ไปกลับ

RangeElement — ผลการค้นหาที่แสดงตําแหน่งของข้อความค้นหา หรือมีค่า Null หากไม่มีรายการที่ตรงกัน

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

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

`getAlignment()`

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

ไปกลับ

HorizontalAlignment — การตรวจสอบความสอดคล้อง

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

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

`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.");
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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

`getHeading()`

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

ไปกลับ

ParagraphHeading — ส่วนหัว

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

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

`getIndentEnd()`

เรียกข้อมูลการเยื้องสิ้นสุดเป็นจุด

ไปกลับ

Number — การเยื้องสิ้นสุด เป็นจุด

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

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

`getIndentFirstLine()`

เรียกข้อมูลการเยื้องบรรทัดแรกในจุด

ไปกลับ

Number — การเยื้องบรรทัดแรกในจุด

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

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

`getIndentStart()`

เรียกข้อมูลการเยื้องเริ่มต้น

ไปกลับ

Number — การเยื้องเริ่มต้น

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

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

`getLineSpacing()`

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

ไปกลับ

Number — ระยะห่างระหว่างบรรทัด เป็นจุด

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

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

`getLinkUrl()`

เรียก URL ของลิงก์

ไปกลับ

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

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

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

`getParent()`

เรียกองค์ประกอบหลักขององค์ประกอบ

องค์ประกอบระดับบนมีองค์ประกอบปัจจุบัน

ไปกลับ

ContainerElement — องค์ประกอบระดับบน

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

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

`getPositionedImage(id)`

รับ PositionedImage ตามรหัสของรูปภาพ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`id`	`String`	รหัสรูปภาพ

ไปกลับ

PositionedImage — รูปภาพที่กําหนดตําแหน่ง

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

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

`getPositionedImages()`

รับออบเจ็กต์ PositionedImage ทั้งหมดซึ่งตรึงอยู่กับย่อหน้า

ไปกลับ

PositionedImage[] — รายการรูปภาพที่กําหนดตําแหน่ง

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

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

`getSpacingAfter()`

เรียกข้อมูลช่องว่างหลังองค์ประกอบ เป็นจุด

ไปกลับ

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

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

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

`getSpacingBefore()`

เรียกข้อมูลช่องว่างก่อนองค์ประกอบ ในจุด

ไปกลับ

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

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

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

`insertHorizontalRule(childIndex)`

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

พารามิเตอร์

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

ไปกลับ

HorizontalRule — องค์ประกอบกฎแนวนอนใหม่

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

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

`insertInlineImage(childIndex, image)`

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

พารามิเตอร์

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

ไปกลับ

InlineImage — องค์ประกอบรูปภาพในบรรทัดที่แทรกไว้

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

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

`insertInlineImage(childIndex, image)`

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

พารามิเตอร์

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

ไปกลับ

InlineImage — องค์ประกอบรูปภาพในบรรทัดที่แทรกไว้

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

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

`insertPageBreak(childIndex)`

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

พารามิเตอร์

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

ไปกลับ

PageBreak — องค์ประกอบตัวแบ่งหน้าใหม่

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

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

`insertPageBreak(childIndex, pageBreak)`

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

พารามิเตอร์

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

ไปกลับ

PageBreak — องค์ประกอบตัวแบ่งหน้าที่แทรกไว้

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

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

`insertText(childIndex, text)`

สร้างและแทรกองค์ประกอบของข้อความใหม่ในดัชนีที่ระบุ

พารามิเตอร์

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

ไปกลับ

Text — องค์ประกอบของข้อความใหม่

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

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

`insertText(childIndex, text)`

แทรกองค์ประกอบ Text ที่ระบุที่ดัชนีที่ระบุ พร้อมด้วยเนื้อหาข้อความที่ระบุ

พารามิเตอร์

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

ไปกลับ

Text — องค์ประกอบข้อความที่แทรก

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

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

`isLeftToRight()`

เรียกข้อมูลการตั้งค่าจากซ้ายไปขวา

ไปกลับ

Boolean — การตั้งค่าจากซ้ายไปขวา

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

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

`merge()`

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

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

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

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
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();

ไปกลับ

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

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

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

`removeChild(child)`

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

พารามิเตอร์

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

ไปกลับ

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

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

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

ไปกลับ

Paragraph — องค์ประกอบที่นําออก

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

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

`removePositionedImage(id)`

นํา PositionedImage ออกตามรหัสของรูปภาพ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`id`	`String`	รหัสรูปภาพ

ไปกลับ

Boolean — ลบรูปภาพที่ระบุหรือไม่

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

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

`replaceText(searchPattern, replacement)`

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

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

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

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

`setAlignment(alignment)`

ตั้งค่าHorizontalAlignment

พารามิเตอร์

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

ไปกลับ

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

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

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

พารามิเตอร์

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

ไปกลับ

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

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

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

`setHeading(heading)`

ตั้งค่าParagraphHeading

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`heading`	`ParagraphHeading`	ส่วนหัว

ไปกลับ

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

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

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

`setIndentEnd(indentEnd)`

ตั้งค่าการเยื้องท้ายเป็นจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`indentEnd`	`Number`	การเยื้องท้ายบรรทัด

ไปกลับ

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

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

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

`setIndentFirstLine(indentFirstLine)`

ตั้งค่าการเยื้องบรรทัดแรกในจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`indentFirstLine`	`Number`	การเยื้องบรรทัดแรก จุดเข้า

ไปกลับ

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

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

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

`setIndentStart(indentStart)`

ตั้งค่าการเยื้องเริ่มต้นในจุด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`indentStart`	`Number`	การเยื้องต้นแต้ม

ไปกลับ

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

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

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

`setLeftToRight(leftToRight)`

กําหนดการตั้งค่าจากซ้ายไปขวา

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`leftToRight`	`Boolean`	การตั้งค่าจากซ้ายไปขวา

ไปกลับ

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

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

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

`setLineSpacing(multiplier)`

กําหนดระยะห่างของบรรทัดเป็นปริมาณที่ระบุจํานวนบรรทัดที่จะใช้ในระยะห่าง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`multiplier`	`Number`	จํานวนบรรทัด

ไปกลับ

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

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

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

`setLinkUrl(url)`

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

พารามิเตอร์

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

ไปกลับ

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

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

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

`setSpacingAfter(spacingAfter)`

กําหนดระยะห่างหลังองค์ประกอบ เป็นจุด

พารามิเตอร์

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

ไปกลับ

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

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

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

`setSpacingBefore(spacingBefore)`

กําหนดช่องว่างก่อนองค์ประกอบ เป็นจุด

พารามิเตอร์

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

ไปกลับ

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

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

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

`setText(text)`

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

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

พารามิเตอร์

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

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

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

พารามิเตอร์

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

ไปกลับ

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

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

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