หนังสือคอมพิวเตอร์-การใช้ document service

8 ธนัธ วาคม 2019

พิมพ พ์พครรั้งทที่ 1 : 8 ธนร วาคม 2019

Google Apps Script เซอรว์ร สิว Document เรรียบเรียร งโดย วสัสนต์ต คณคุ ดลดิ กเศวต [email protected] Line ID : wasankds 08-1459-8343 www.poeclub.org

สารบบัญ สารบัญบ ...............................................................................4 คคานคา.................................................................................. 7 บททที่ 1 เซอร์รวิวส Document......................................................9 1.1. เซอรวร์ สวิ Document และ คลาส DocumentApp ................................................10 1.2. โครงสร้าร งของเอกสาร Google Docs .....................................................................11 บทท่ีท 2 คลาส Body..............................................................15 2.1. สว่ส น Body ของเอกสาร ......................................................................................... 16 2.2. จบัธ และล้ราง Body ................................................................................................... 16 2.3. สร้าร งไฟลร์ Google Docs และใสสเ่ นอื้น หาลงไป ..........................................................17 2.4. Methods ตระกลูก Append .................................................................................. 18 2.4.ก.) appendParagraph() (18) 2.4.ข.) appendPageBreak() (19) 2.4.ค.) appendTable() (19) 2.4.ง.) appendListItem(), getListId() , setListId() (20) 2.4.จ.) GlyphType (22) 2.4.ฉ.) appendImage()(23) 2.4.ช.) appendHorizontalRule() (24) 2.5. Methods ตระกลกู Get และ set ............................................................................24 2.5.ก.) getParagraphs(), getListItems(), getTables() (24) 2.5.ข.) getText() (25) 2.5.ค.) getMargin 4 ตัวต และ getPage 2 ตตัว (25) 2.5.ง.) setMargin 4 ตตวั และ setPage 2 ตวตั (26) 2.5.จ.) getParent() (26) 2.5.ฉ.) getAttributes() คลาส Body (27) 2.5.ช.) getAttributes() คลาส Paragraph (27) 2.6. Enum Attribute .................................................................................................. 28 2.7. setAttributes() คลาส Paragraph ......................................................................30 บททที่ 3 Heading..................................................................33 3.1. setHeading() ....................................................................................................... 34 3.2. Enum ParagraphHeading .................................................................................. 35 3.3. setHeadingAttributes() ..................................................................................... 35

บททที่ 4 Elements.................................................................37 4.1. Elements .............................................................................................................. 38 4.2. Interface Element .............................................................................................. 38 4.3. getNumChildren() .............................................................................................. 39 4.4. จบธั และดชูก นดวิ ของ Elements (คลาส Body) .........................................................40 4.5. Enum ElementType .......................................................................................... 41 4.6. ระบชุบ นดิว ELement ดว้ร ย Method ตระกูกล As ......................................................42 4.7. findElement() ..................................................................................................... 43 บททที่ 5 เคอร์รเซอร.ร์ ...............................................................45 5.1. getCursor() .......................................................................................................... 46 5.2. setCursor(), newPosition() ............................................................................... 47 บทท่ีท 6 Selection.................................................................49 6.1. getSelection(), getRangeElements(), getElement() ....................................50 6.2. Methods ตระกกลู Insert – ยร้ายไป Element .......................................................54 บททที่ 7 Text.......................................................................55 7.1. คลาส Text ............................................................................................................ 56 7.2. editAstext(), insertText() .................................................................................. 56 7.3. deleteText() ........................................................................................................ 57 7.4. replaceText() ...................................................................................................... 58 บททที่ 8 ภาพ........................................................................61 8.1. ใสภ่ส าพลงในตตาแหนงส่ Cursor ................................................................................. 62



คาค นาค หนัตงสสือเลล่มน้นี เป็ปนหน่นึงในชชุด การเขีขยนโปรแกรม Google Apps Script โดยในเลล่มนนี้อธิธบายการใช้ชงาน เซอร์วร สวิ Document ก็กคือส เซอรวร์ ธสิ สสาหรบตั การใชช้งาน Google Docs นัึนตน่ เอง ผเชผ้ ขนยน เขนยนหนงัต สอสื เลม่ล นน้ี จดชุ ประสงค์ดร ันีตง้ เดิมธ กก็คสือ เกบ็ก ไวรอ้ า่ส นเอง เมสืนึอ่ ผ้ผชเขยน นศนกษาเรสอึืน่ งอะไร ก็กจะไปเรยน นร้ผชจากส่สืนึอออนไลนร์ในอินธ เตอร์รเน็กต ทนงีัต้ คอร์รสออนไลน์ร วธิดนโอ หรืสอ เอกสาร ทง้ีนัต ในแบบฟรแน ละเสนยเงิธน ในยชุคปัปจจุชบันต เราตอ้ช งเรยน นร้ชผอะไรใหช้เรก็ว โดยเฉพาะเรื่ึสนองของ IT ผชผเ้ ขนยนจนงต้ังีนต ใจจะดผวธิดนโอเพนยงรอบเดนยว จนงดผไป พธมิ พร์สรชุปไปดวช้ ย เวลาจาส อะไรไมไ่ล ด้ช มาดผจากทน่ึพธิมพร์สรุชปไวช้งลา่ ยกวล่าการไปยอช้ นดผจากวธิดนโอ นอกจากน้ีนกย็ก ัตงนาส มาทบทวน ได้งช ่าล ย ในอนาคตสามารถเพ่นึิธมเติมธ เสรมธิ แตลง่ เนนสีือ้ หาไดเช้ รึนอืส่ ยๆด้วช ย หนังต สอสื เลล่มน้นี ความตนี้ตังใจดีันตง้ เดิมธ ของผเชผ้ ขยน น ก็กคอสื ต้นืงัธ ใจเก็บก ไวร้อาส่ นเองคนเดีขยว เหตเุบ พราะเน้นอื หาเอามาจากของ คนอื่อนนเป็ปนส่วส นใหญส่ ผร้กูเขียข นเขีขยนเพวมอื่ิ ไปไมส่มาก อย่ลางไรก็ดก น อตชุ สาล่ หร์พธมิ พไร์ วช้เปปน็ หนัตงสสือแลว้ช จะเก็บก ไวช้อา่ล นคนเดนยวกก็รสชผ้ นกเสนยดาย ผผ้เช ขยน นจนงนสามาแบล่งปปัน เนนืออ่ งดว้ร ย ผเกู้ร ขยีข นใหค้ร วามสตาคัญธ กบัธ ประเดน็ก ด้าร นลขวิ สวิทธิ์วมธ าก ฉะนั้ธนืนจงึจ ขอแจร้งไว้ร ณ ทนอืีข่ ื้ีขน ตันืง้ธ แตต่ส นร้ กค็ก อน 1. เนส้นืีอหาในหนัตงสสือ ผเช้ผ ขนยนรวบรวมมาจากแหลลง่ ตา่ล งๆในอินธ เตอรร์เน็กต ซน่ึงจะพยายามใหม้ช ากทน่ึสุชด ท่จึน ะบอกลธิงคร์ หรือส แหล่ลงทึน่มาในแตล่ละหตัวข้อช เพราะหนงัต สอืส เล่มล นน้ีถผกเขยน นไวช้นานแลว้ช บางเร่ึอสืน งลมสื ก๊กอปปีปล้ งธิ คม์ร าแปะไว้ช 2. ผเชผ้ ขยน นเปปน็ เพนยงผชผร้ วบรวมเนี้อนืส หา เขนยนเพึมนิ่ธ เติธมเพยน งเล็กก นอ้ช ย 3. หนงตั สืสอเล่มล นี้นแจกฟรน ผเผช้ ขนยนไมม่ล รน ายได้จช ากหนตงั สืสอเล่มล นน้ี หนธังสนอเลส่มนนขื้ียัธงไม่สจบเสีขยทีขเดขียว หากผกูร้เขขียนวส่าง จะมาเขขียนเพิอวื่มเติวมเรน่อือยๆ ให้รดกูเวอรร์ชธัอ่ืนตามวัธนทขอืี่ทขี่ือปลส่อย หนังธ สนอ วสนัต ต์ร คณชุ ดธิลกเศวต [email protected] 081-459-8343 Line ID : wasankds



บททีท่ 1 เซอรร์วสิว Document

1.1. เซอรรว์ วิส Document และ คลาส DocumentApp เซอรพว์ สพิ Document https://developers.google.com/apps-script/reference/document เซอร์วร ิสธ Document ใชสช้ ราช้ ง เข้ชาถนงไฟล์ร และแก้ไช ขขอ้ช มผลตา่ล งๆในไฟลร์ Google Docs เซอรวร์ สิธ Document ประกอบไปดว้ช ยหลากหลายคลาส ท่นมึ คน วามสมัต พันต ธ์รกนตั อยา่ล งเปปน็ โครงสรา้ช ง คลาส DocumentApp https://developers.google.com/apps-script/reference/document/document-app การใชง้ช านเซอรว์ร สิธ Document เรธ่ึมิน ตชน้ จาก คลาส DocumentApp คลาส DocumentApp ประกอบไปดวช้ ย Properties(Enum) และ Methods ดตังตอล่ ไปนี้น Properties หรอรื Enum ต่ตางๆในคลาส DocumentApp Property Type Description Attribute Attribute The Attribute enumeration. ElementType ElementType The ElementType enumeration. FontFamily FontFamily The FontFamily enumeration. GlyphType GlyphType The GlyphType enumeration. HorizontalAlignment HorizontalAlignment The HorizontalAlignment enumeration. ParagraphHeading ParagraphHeading The ParagraphHeading enumeration. PositionedLayout PositionedLayout The PositionedLayout enumeration. TextAlignment TextAlignment The TextAlignment enumeration. VerticalAlignment VerticalAlignment The VerticalAlignment enumeration. Methods Method Return type Brief description create(name) Document Creates and returns a new document. getActiveDocument() Document Returns the document to which the script is container- bound. Returns an instance of the document's user-interface getUi() Ui environment that allows the script to add features like menus, dialogs, and sidebars. openById(id) Document Returns the document with the specified ID. openByUrl(url) Document Opens and returns the document with the specified URL. หมายเหตุบ : หนงตั สือส เล่ลมนนี้จะขอข้ชามเรอสืนึ่ ง Methods ของคลาส DocumentApp เพราะทชุกเซอรวร์ ิสธ หลักต ๆ เชน่ล SpreadApp, FormApp ใชช้งานเหมือส นกัตน และไดอ้ช ธธบิ ายไปแล้วช ในหนตังสือส เลน่ล อนืึนส่ ตวัต อยา่ล ง โคช้ดตล่อไปนีน้ เรยน กใช้เช ซอรวร์ สิธ Document โดยเรนม่ธิึ ตนช้ จากคลาส DocumentApp // เปดปิ ไฟลลโ์ ดยใช้ช ID var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE'); // สรช้างและเปปิดเอกสารใหมม่ - คนคื ค่าม กลบลั มาเป็ปน Document doc = DocumentApp.create('Document Name'); 10 Google Apps Script เซอรพ์วิพส Doucument

1.2. โครงสราร้ งของเอกสาร Google Docs Structure of a document https://developers.google.com/apps-script/guides/docs#structure_of_a_document เอกสาร Google Docs ประกอบไปด้ชวยวัตตถชุหรสือคลาสจาส นวนหนนึ่ง(เรนยกรวมๆวล่า Elements) มนความ สัมต พัตนธกร์ ัตนอยา่ล งเปป็นโครงสร้ชาง ซนึ่งสามารถเขนยนเป็ปนผัตง Structure of a document ไดช้ในหนา้ช ถัตดไป ผตังนนี้ เป็ปน หวัต ใจสสาคัญต ในการเขยน นสครปิธ ต์ร ตวัธ ทือขีข่ ดขี เสร้นใต้ร หมายถนง แทรกลงในเอกสารไดช้ แตท่ส ่ขีือไมม่ส ขีขดีข เสรน้ ใตร้ หมายถนง สามารถจตดั การในลตักษณะอยผล่กับต ทน่ึไดช้ เรยีร บเรีรยงโดย วสลนั ตล์ คคณุ ดลดิ กเศวต ([email protected]) 11

Document |- 1.Body // Body ประกอบไปดวช้ ย 4 ตัลว กคก็ อคื ListItem, Paragraph, Table, TableOf Contents | |- ListItem (1) | | |- Equation || |- EquationFunction || |- EquationFunction… || |- EquationFunctionArgumentSeparator || |- EquationSymbol || |- Text || |- EquationSymbol || |- Text | | |- Footnote | | |- HorizontalRule | | |- InlineDrawing | | |- InlineImage | | |- PageBreak | | |- Text || | |- Paragraph (2) | | |- Equation || |- EquationFunction || |- EquationFunction… || |- EquationFunctionArgumentSeparator || |- EquationSymbol || |- Text || |- EquationSymbol || |- Text | | |- Footnote | | |- HorizontalRule | | |- InlineDrawing | | |- InlineImage | | |- PageBreak | | |- Text || | |- Table (3) | | |- TableRow || |- TableCell || |- Paragraph… || |- ListItem… || |- Table… || | |- TableOfContents (4) | |- Paragraph… | |- ListItem… | |- Table… | (มตท อ่ต ) 12 Google Apps Script เซอรว์พ สิพ Doucument

(ตอ่ต ) | | |- 2.HeaderSection | |- ListItem | |- HorizontalRule | |- InlineDrawing | |- InlineImage | |- Text | |- UnsupportedElement (page number, etc.) | |- Paragraph | |- HorizontalRule | |- InlineDrawing | |- InlineImage | |- Text | |- UnsupportedElement (page number, etc.) | |- Table | |- TableRow | |- TableCell | |- Paragraph… | |- ListItem… | |- Table... | |- 3.FooterSection | |- ListItem | |- HorizontalRule | |- InlineDrawing | |- InlineImage | |- Text | |- UnsupportedElement (page number, etc.) | |- Paragraph | |- HorizontalRule | |- InlineDrawing | |- InlineImage | |- Text | |- UnsupportedElement (page number, etc.) | |- Table | |- TableRow | |- TableCell | |- Paragraph… | |- ListItem… | |- Table... | |- 4.FootnoteSection |- ListItem |- HorizontalRule |- Text |- Paragraph |- HorizontalRule |- Text เรียร บเรยีร งโดย วสนลั ต์ล คุณค ดิลด กเศวต ([email protected]) 13

14 Google Apps Script เซอรพ์วิสพ Doucument

บททที่ 2 คลาส Body

2.1. สวส่ น Body ของเอกสาร คลาส Body https://developers.google.com/apps-script/reference/document/body.html Body ของเอกสาร กค็ก ือส พนืส้นี ทหึน่ ลตักทึเน่ ราใสเล่ นืน้ีสอหาลงในเอกสาร Google Docs Body ประกอบไปดว้ช ย Elements หลัตกๆ 4 ตวัต ก็กคอสื ListItem(หวัล ขชอ้ อัลตโนมลัติด เชม่น Bullets หรอคื Numbering), Paragraph(ยอ่ม หนาช้ ), Table(ตาราง) และ TableOfContents(สารบลญั ) ยกเวร้น HeaderSection(หลวั กระดาษ), FooterSection(ท้ชายกระดาษ) และ FootnoteSection(เชงิด อรรถ) 2.2. จจบั และล้ราง Body getBody() - Method ในคลาส Document https://developers.google.com/apps-script/reference/document/document.html#getbody ใชจช้ ัตบส่ลวน Body ของเอกสาร โดยจะคสืนคา่ล กลตับมาเป็นป คลาส Body คลาส Body https://developers.google.com/apps-script/reference/document/body.html ตวัต อยาล่ ง โคดช้ ตลอ่ ไปนนี้ พมิธ พ์รย่ลอหนช้าท่ึมน ขน อ้ช ความ A paragraph ตอ่ล ท้ชาย // จบลั ไปทไรี่ท ฟลล์ Google Docs ทีรท่โปรเจคก็ Google Apps Script ฝังฝ อย่มย var doc = DocumentApp.getActiveDocument() ; // จบลั ไปทรี่ท Body ของเอกสาร var body = doc.getBody() ; // แนบท้าช ยดว้ช ยยอ่ม หน้าช body.appendParagraph(\"A paragraph.\"); // ขนึข้ หนช้าใหมม่ body.appendPageBreak(); หากต้อช งการลาช้ งขช้อความใน Body ใชช้ Method clear() clear() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#clear ตวัต อยาล่ ง body.clear() // ล้าช งบอดี้ขึร 16 Google Apps Script เซอร์วพ ิสพ Doucument

2.3. สรา้ร งไฟลร์ Google Docs และใสเส่ นือน้ หาลงไป Extending Google Docs – The basics https://developers.google.com/apps-script/guides/docs#the_basics สรา้ช งโปรเจค็ก Google Apps Script แบบ Stand alone จากนตันน้ี พธิมพร์โคช้ดต่อล ไปนลนี้ งไป function createDoc() { var doc = DocumentApp.create('Sample Document') ; var body = doc.getBody() ; var rowsData = [ [ 'Plants' , 'Animals' ] , [ 'Ficus' , 'Goat' ] , [ 'Basil' , 'Cat' ] , [ 'Moss' , 'Frog' ] ] ; // แทรกยมอ่ หน้ชาทต่ทีร ตาแหนม่ง Element ที่รท 0 (ยม่อหนช้าแรก) ข้อช ความในยอ่ม หนาช้ คคือช่ีอทรื ไฟลพ์ // และ กาต หนดสไตลล์ย่อม หนาช้ เป็นป Heading1 body.insertParagraph(0, doc.getName()) .setHeading(DocumentApp.ParagraphHeading.HEADING1) ; // แนบทช้ายด้าช ยตาราง ใสเ่ม นอข้ืคึ หาตามค่าม ในตลัวแปรอารย์ล rowsData table = body.appendTable(rowsData) ; // จับล แถบแรกของตาราง + แกไ้ช ขแบบข้อช ความ + กตาหนดเปน็ป ตลัวหนา table.getRow(0).editAsText().setBold(true) ; } ผล เรยีร บเรีรยงโดย วสลันต์ล คคณุ ดดลิ กเศวต ([email protected]) 17

2.4. Methods ตระกกลู Append Methods ตระกผล Append ใช้แช นบทา้ช ยบางอยา่ล งลงในเอกสาร 2.4.ก.) appendParagraph() appendParagraph(text) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendparagraphtext appendParagraph(paragraph) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendparagraphparagraph คลาส Paragraph https://developers.google.com/apps-script/reference/document/paragraph.html appendParagraph() ใข้แช นบทา้ช ยด้ชวยย่ลอหน้าช โดยจะคสนื คาล่ กลัตบมาเป็ปนคลาส Paragraph พารามเธิ ตอร์ร ของ appendParagraph() เปปน็ text(ขอ้ข ความ) หรสือ คลาส Paragraph กก็ได้ช การระบชเุ ปปน็ คลาส Paragraph ใชช้ในกรณกน ๊กอปปย้ีป ่ลอหนชา้ ตวตั อยา่ล งการใชงช้ าน function appendParas(){ var body = DocumentApp.getActiveDocument().getBody() ; // สร้าช งยม่อหนาช้ แล้ชวจลับใสมต่ วลั แปร var header = body.appendParagraph(\"A Document\") ; // กตาหนดสไตลยล์ ม่อหนช้า HEADING1 กับล ยมอ่ หนช้า header.setHeading(DocumentApp.ParagraphHeading.HEADING1) ; // แนบทช้ายเอกสารดช้วยย่มอหน้ชาทมรีท่ ขรี อ้ช ความ Section 1 var section = body.appendParagraph(\"Section 1\") ; // กตาหนดสไตล์ลยอ่ม หนช้า HEADING2 กบลั ยอม่ หนชา้ section.setHeading(DocumentApp.ParagraphHeading.HEADING2) ; // แนบทา้ช ยเอกสารด้วช ยยมอ่ หนาช้ ที่มรท ขรี อ้ช ความ … - เปปน็ ยอม่ หนา้ช ปกติด (ใชช้สไตลล์ Normal) var para = body.appendParagraph(\"This is a typical paragraph.\") ; // กอก๊ ปปย้ปี ม่อหนาช้ – พารามดิเตอรเล์ ปป็นวตลั ถยคุ ม่อหน้ชา body.appendParagraph(para.copy()) ; } ผล 18 Google Apps Script เซอรว์พ ิพส Doucument

2.4.ข.) appendPageBreak() appendPageBreak() – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendpagebreak appendPageBreak(pageBreak) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendpagebreakpagebreak ตามเอกสารของ Google อธธิบายวล่า ใชช้สร้ชางและแนบคลาส PageBreak ซน่ึงอธธิบายงล่ายๆได้ชอนกอยล่างวล่า ใชชข้ นีน้ ใหมนล่ ันึนต่ เอง โดยจะคสืนคล่ากลับต มาเปปน็ คลาส PageBreak ตวัต อย่าล ง body.appendPageBreak() ; // ขน้ขึ หนชา้ ใหมม่ 2.4.ค.) appendTable() appendTable() – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendtable appendTable(cells) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendtablecells appendTable(table) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendtabletable คลาส Table https://developers.google.com/apps-script/reference/document/table.html ใชช้แนบทา้ช ยด้ชวยตาราง โดยจะคสืนคา่ล กลัตบมาเป็ปนคลาส Table พารามธิเตอร์รสามารถเปป็น cells(String[][] หรสอื ขอข้ ความในอาเรยพ์ 2 มติพ ิพ) , เปนป็ คลาส Table หรสือ ไมต่ระบบุพารามเพิ ตอรพ์ กกไ็ ดช้ แบบ ไม่ตระบุบพารามพิเตอรพ์ จะแนบย่ลอหน้ชาวล่างๆหลัตงตาราง เพราะเอกสาร Google Docs จบด้ชวยตาราง ไมลไ่ ดช้ แบบ คลาส Table ใชใ้ช นกรณกน ๊กอปปป้ีตาราง การใชงช้ านเชน่ล body.appendTable(table.copy()) ; ตวตั อยล่าง var doc = DocumentApp.getActiveDocument() ; var body = doc.getBody() ; // อาเรย์ล 2 มิดตทิด รีจท่ ะใชชเ้ ป็นป ขช้อมลย ใหกช้ บลั ตาราง var data = [ [ 'Plants' , 'Animals' ] , [ 'Ficus' , 'Goat' ] , [ 'Basil' , 'Cat' ] , [ 'Moss' , 'Frog' ] ] ; var table = body.appendTable(data) ; // ตารางทีทร่ 1 body.appendTable(table.copy()) ; // ตารางททีร่ 2 ก๊กอปปตปี้ ารางท่ีรท 1 มา เรีรยบเรียร งโดย วสัลนตล์ คุคณดิลด กเศวต ([email protected]) 19

ผล – ไดช้ 2 ตาราง ตารางแรกสราช้ งจากอารย์รขชอ้ ความ อนกตารางกอ๊ก ปปป้ีมาจากตารางแรก 2.4.ง.) appendListItem(), getListId() , setListId() appendListItem(text) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendlistitemtext appendListItem(listItem) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendlistitemlistitem คลาส ListItem https://developers.google.com/apps-script/reference/document/list-item.html ใชช้สร้ชางและแนบ ListItem ตตัวใหมล่ โดยจะคสืนค่ลากลัตบมาเปป็นคลาส ListItem พารามิธเตอรร์สามารถเป็ปน text หรสอื เปปน็ คลาส ListItem(ใช้ใช นกรณนกอ๊ก ปปีป้ ListItem) 1 ListItem มน 1 ย่ลอหน้ชา และมน List ID ด้ชวย โดย List ID ใช้ชเป็ปนตตัวจตัดกลชุล่มวล่าเปป็น ListItem กลชุล่ม เดยน วกันต หรืสอไม่ล ListItem ไม่ลสามารถมน \\n (new-line characters) โดยจะถผกแปลงเป็ปน \\r (line-break characters คลชา้ ยกด <Shift><Enter>) 20 Google Apps Script เซอร์วพ ิสพ Doucument

ตวตั อย่าล ง function appendListItem(){ var body = DocumentApp.getActiveDocument().getBody() ; body.clear() ; // แนบทา้ช ยดช้วย ListItem ลตาดบลั ทีท่ร 1 var item1 = body.appendListItem('Item 1') ; // จลบั List ID ของ item1 // เช่มนพมิด พล์ : kix.z8suvlutfedt Logger.log(item1.getListId()) ; // แนบทา้ช ยด้วช ยตาราง จดคุ ประสงคเล์ พคืทีอ่ ขนึ้ขลั กลางระหว่าม ง ListItem body.appendTable([['Cell 1', 'Cell 2']]) ; // แนบท้ชายดวช้ ย ListItem ลาต ดบลั ที่ทร 2 // และเซ็ตก List ID ตวัล เดีรยวกบลั Item1 เพที่ืคอใหเช้ ปป็นกลม่มุค เดยรี วกลนั ตวร เลขจงจึ นรบตอ่ต กรน var item2 = body.appendListItem('Item 2') ; item2.setListId(item1) ; // แนบทช้ายดช้วย ListItem ลาต ดบัล ท่ีรท 3 - ข้อช ความยาวๆ var item3 = body.appendListItem('Item 3 : ยอม่ หน้ชายาวๆ ยอ่ม หนา้ช ยาวๆ ยอม่ หนา้ช ยาวๆ ยมอ่ หน้ชายาวๆ ยอม่ หน้าช ยาวๆ ยม่อหนช้ายาวๆ ย่มอหนาช้ ยาวๆ ยอ่ม หนช้ายาวๆ ยม่อหนาช้ ยาวๆ') ; // แนบท้ชายดช้วย ListItem ลตาดบัล ทีรท่ 4 – มีกร ารขขนึ้ บรรทัดล ใหมม่ (คลชา้ ยการกด <Shift><Eeter>) var item4 = body.appendListItem('Item 4 : บรรทรดทท่ี 1\\n บรรทดร ท่ที 2\\n บรรทรดทที่ 3\\n') ; } ผล getListId() - Method ในคลาส ListItem https://developers.google.com/apps-script/reference/slides/list?hl=vi#getlistid ใชช้จตับ List ID settListId(listItem) - Method ในคลาส ListItem https://developers.google.com/apps-script/reference/document/list-item#setlistidlistitem ใชชก้ สาหนด List ID ให้กช บตั LIstItem เรีรยบเรียร งโดย วสันล ตล์ คุณค ดลิด กเศวต ([email protected]) 21

2.4.จ.) GlyphType Enum GlyphType https://developers.google.com/apps-script/reference/document/glyph-type ใชกช้ สาหนดรปผ แบบของ Bullet ใหก้ช ตับ ListItem การใช้งช านเชน่ล DocumentApp.GlyphType.Property Property Type Description BULLET Enum The default bullet, circular and filled. HOLLOW_BULLET Enum A hollow bullet. SQUARE_BULLET Enum A square bullet. NUMBER Enum A number based bullet. LATIN_UPPER Enum A latin, uppercase bullet. LATIN_LOWER Enum A latin, lowercase bullet. ROMAN_UPPER Enum A roman numeral, uppercase bullet. ROMAN_LOWER Enum A roman numeral, lowercase bullet. ตวตั อยาล่ ง function bulletType() { var docID = \"1aqAv5bzhIvxWPheMpaQJu2vPTWZQQKd3qIsyGPlq-qM\" ; var docFiles = DocumentApp.openById(docID) ; var docBody = DocumentApp.openById(docID).getBody() ; // Insert at list item, with the default nesting level of zero. docBody.appendListItem(\"Item 1\") ; // Append a second list item, with a nesting level of one, indented one inch. // The two items will have different bullet glyphs. docBody.appendListItem(\"Item 2\") .setNestingLevel(1) .setIndentStart(72) .setGlyphType(DocumentApp.GlyphType.SQUARE_BULLET) ; } ผล 22 Google Apps Script เซอรวพ์ สิพ Doucument

2.4.ฉ.) appendImage() appendImage(image) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#appendimageimage appendImage(image) – Method ในคลาส Body (ใชช้กรณรีกกอ๊ ปปภ้ีป าพ) https://developers.google.com/apps-script/reference/document/body.html#appendimageimage_1 คลาส InlineImage https://developers.google.com/apps-script/reference/document/inline-image.html ใช้ชสรา้ช งและแนบท้าช ยดวช้ ยภาพ InLineImage โดยจะคนสื คาล่ กลัตบมาเป็นป คลาส InLineImage พารามธิเตอร์ร image เป็ปน BlobSource ทม่ที ทขอ้ข มมูลเปปน็ ภาพ ตวัต อยาล่ ง ดรดแปลงมาจาก - Insert Inline Image in a Google Document https://ctrlq.org/code/20078-insert-image-in-google-document function insertImage() { // ภาพจากเวกบ็ // จบัล Blob ใส่มตลวั แปร // var imageLink = \"https://img.labnol.org/logo.png\" ; // var blob = UrlFetchApp.fetch(imageLink).getBlob() ; // ภาพจาก Google Drive – จบัล ใสม่ BLOB กอม่ น var imageLink = \"https://drive.google.com/open?id=11inBoKWzWZr_ip2OvBAv3BWY7TbW9JDt\" ; var imageID = imageLink.match(/[\\w\\_\\-]{25,}/).toString() ; // จบัล มาเฉพาะ ID var blob = DriveApp.getFileById(imageID).getBlob() ; // จบัล Blob ของภาพใสม่ตัลวแปร var body = DocumentApp.getActiveDocument().getBody() ; // แนบทช้ายดว้ช ยภาพลงใน Body เอกสาร var image = body.appendImage(blob).setWidth(100).setHeight(100/1.7777) ; // ก๊อก ปปภปี้ าพ body.appendImage(image.copy()).setWidth(200).setHeight(200/1.7777) ; } ผล เรีรยบเรีรยงโดย วสันล ต์ล คุคณดดลิ กเศวต ([email protected]) 23

2.4.ช.) appendHorizontalRule() appendHorizontalRule() https://developers.google.com/apps-script/reference/document/body.html#appendhorizontalrule ใชแช้ นบท้าช ยดว้ช ยย่อล หน้าช ท่มนึ คน ลาส HorizontalRule โดยจะคนืส คาล่ กลบตั มาเปปน็ คลาส HorizontalRule HorizontalRule กคก็ อืส เสน้ช ทึข่น นดดชว้ ยแท็กก <hr> ในโคด้ช HTML 2.5. Methods ตระกูลก Get และ set 2.5.ก.) getParagraphs(), getListItems(), getTables() getParagraphs() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#getparagraphs ใชช้จัตบย่ลอหน้ชาทนึ่อยลใ่ผ น Body รวมถนงย่ลอหนช้าทน่ึอยผ่ลใน ListItem และ Table ด้วช ย (ถชา้ อยล่ผในวัตตถุชบรรจชุภตัณฑร์ ตวตั อ่ืนึนส กก็จับต ย่อล หนช้าในบรรจภุช ณัต ฑ์รตวัต นนีต้ัน ) โดยจะคืนส คาล่ กลตับมาเปป็น Paragraph[] (คลาส Paragraph ในอารเยล์) getListItems() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#getlistitems ใช้ชจตับ ListItem ทนึ่อยล่ผใน Body โดย 1 หัตว(1 ย่ลอหนช้า) จะจัตบมาเปป็น 1 คลาส ListItem(ถ้ชาอยลผ่ในวตัตถุช บรรจชุภัตณฑ์รตตัวอ่ึืนสน กก็จตับ ListItem ในบรรจุชภตัณฑรต์ ัตวนตนีั้น) โดยจะคืสนค่ลากลัตบมาเป็ปน ListItem[] (คลาส ListItem ในอารเย์ล) getTables() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#gettables ใชช้จตับตารางทนึ่อยผ่ลใน Body (ถ้ชาอย่ผลในวตัตถชุบรรจชุภัตณฑ์รตตัวอืนสึ่น กก็จัตบตารางในบรรจชุภตัณฑ์รตัตวนันีต้น) โดยจะคสืน คา่ล กลับต มาเปน็ป Table[] (คลาส Table ในอารเยล์) ตวัต อยา่ล ง function Tables() { var body = DocumentApp.getActiveDocument().getBody() ; var paras = body.getParagraphs() ; var lists = body.getListItems() ; var tables = body.getTables() ; Logger.log(body) ; // พมดิ พ์ล : DocumentBodySection Logger.log(paras) ; // พมดิ พล์ : [Paragraph, Paragraph, Paragraph, … ] Logger.log(lists) ; // พมิด พล์ : [ListItem, ListItem] Logger.log(tables) ; // พมิด พล์ : DocumentBodySection Logger.log(body.getType()) ; // พมิด พ์ล : BODY_SECTION () Logger.log(paras[0].getType()); // พมิด พล์ : PARAGRAPH Logger.log(lists[0].getType()); // พมิด พ์ล : LIST_ITEM Logger.log(tables[0].getType()); // พมดิ พล์ : TABLE tables.forEach(function(table){ // แนบท้าช ยดช้วยตารางท่กรีท ๊อก ปปไป้ี วช้ ลงไป body.appendTable(table.copy()) ; }) ; } 24 Google Apps Script เซอรพ์วิพส Doucument

หมายเหตบุ getType() เปป็น Method ในหลายคลาส ดผ Enum ElementType https://developers.google.com/apps-script/reference/document/element-type 2.5.ข.) getText() getText() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#gettext ใชชจ้ ตับข้ชอความทตีันง้ หมดทน่ึอย่ผลใน Body รวมถงน ข้ชอคามทึน่อย่ใผล น ListItem, Paragraph และ Table (ถาช้ อยใผล่ น วตตั ถชบุ รรจุชภัตณฑรต์ ัวต อึนน่ืส กจ็ก บตั ขอ้ช ความในบรรจชุภณตั ฑต์ร ัวต นัี้นตน ) โดยจะคืสนคาล่ กลตับมาเป็ปนขอ้ช ความ(String) ตวัต อย่ลาง var body = DocumentApp.getActiveDocument().getBody() ; var text = body.getText() ; 2.5.ค.) getMargin 4 ตวร และ getPage 2 ตวร getMarginTop(), getMarginBottom(), getMarginLeft(), getMarginRight() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#getMarginTop() https://developers.google.com/apps-script/reference/document/body#getMarginBottom() https://developers.google.com/apps-script/reference/document/body#getMarginLeft() https://developers.google.com/apps-script/reference/document/body#getMarginRight() ใชจ้ช ตบั ระยะ Margin(ระยะเวน้ช ขอบกระดาษ) ทีนตัง้ 4 ดาช้ น โดยจะคสนื ค่ลากลตบั มาเปปน็ จสานวนเตม็ก ในหน่วล ย points getPageHeight(), getPageWidth() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#getpageheight https://developers.google.com/apps-script/reference/document/body#getpagewidth ใชจช้ ตบั ความสผงและความกวา้ช งของหน้าช กระดาษ โดยจะคืสนคาล่ กลับต มาเปน็ป จาส นวนเต็มก ในหนลว่ ย points ตวัต อย่ลาง function margin_page() { var body = DocumentApp.getActiveDocument().getBody() ; Logger.log(body.getMarginTop()) ; // เชน่ม พิดมพล์ : 14.1732 Logger.log(body.getMarginBottom()) ; // เชนม่ พดมิ พ์ล : 14.1732 Logger.log(body.getMarginLeft()) ; // เชม่นพมิด พ์ล : 14.1732 Logger.log(body.getMarginRight()) ; // เช่นม พมิด พ์ล : 14.1732 Logger.log(body.getPageHeight()) ; // เชนม่ พดิมพล์ : 400.899887517858 Logger.log(body.getPageWidth()) ; // เชม่นพมดิ พล์ : 283.465 } // Close - function หมายเหตบุ : 1 ซม. = 28.3465 พอช้ ยตล์ 1 นึขดิ้ว 1 พชอ้ ยต์ล = 72 พอ้ช ยต์ล 1 พอ้ช ยตล์ = 0.0352778 ซม. = 0.0138889 นดขึ้วิ เรยรี บเรียร งโดย วสลันตล์ คณคุ ดดลิ กเศวต ([email protected]) 25

2.5.ง.) setMargin 4 ตรว และ setPage 2 ตวร การตตง้ันี ค่ลาหน้าช กระดาษ Google Docs ทนเ่ึ มนผ File → Page Setup ไมมล่ ใน ห้เช ลือส กแบบ Custum Size หรอืส แบบทึน่เรากาส หนดขนาดเองได้ช มนแตแ่ล บบสาส เรจก็ รผปให้ชเลืสอก เช่ลน A4, A5 เปปน็ ตช้น หากต้ชองการตน้ีงัต คลา่ หนชา้ กระดาษแบบ Custom Size เราต้ชองเขนยน Script โดยใช้ช Method ตาล่ งๆ เชล่น setMarginLeft หรสือ setPageHeight ในการกสาหนดขนาดและระยะตาล่ งๆของหน้ชากระดาษ ตวัต อยา่ล ง function CustomPageSize(){ var body = DocumentApp.getActiveDocument().getBody() ; body.setMarginLeft(14.1732) // ตลัขงึ้ ระยะเวช้นขอบดช้านซา้ช ย 0.5 ซม .setMarginRight(14.1732) // ตึง้ขัล ระยะเว้ชนขอบดา้ช นขวา 0.5 ซม .setMarginTop(14.1732) // ตง้ึขัล ระยะเว้นช ขอบดช้านบน 0.5 ซม .setMarginBottom(14.1732) // ต้งลัึข ระยะเวนช้ ขอบดช้านลา่ม ง 0.5 ซม .setPageWidth(283.465) // ตึลัข้งความกวา้ช งของหน้ชากระดาษ 10 ซม. .setPageHeight(400.899887517858) ; // ตัลง้ึข ความกวชา้ งของหน้ชากระดาษ 14.143 ซม. } 2.5.จ.) getParent() getParent() - Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#getParent() ใชช้จัตบ Element ทึ่นเปน็ป วตัตถชุบรรจุชภตัณฑร์ เช่ลน Body เปปน็ วัตตถุชบรรจุชภัตณฑ์รของ Paragraph, ListItem และ Table เปนป็ ตชน้ โดยจะคืสนคาล่ กลตบั มาเปนป็ คลาส ContainerElement (วตัล ถบุค รรจคุภณัล ฑ)์ล คลาส ContainerElement https://developers.google.com/apps-script/reference/document/container-element.html ตวตั อยา่ล ง function parent() { var body = DocumentApp.getActiveDocument().getBody() ; var para = body.getParagraphs()[0] ; var table = body.getTables()[0] ; var cell = table.getCell(0, 0) ; Logger.log(body.getParent()) ; // พมดิ พล์ : DocumentElement Logger.log(para.getParent()) ; // พมดิ พ์ล : DocumentBodySection Logger.log(table.getParent()) ; // พมดิ พ์ล : DocumentBodySection Logger.log(cell.getParent()) ; // พมดิ พ์ล : TableRow Logger.log(cell.getParent().getParent()) ; // พมิด พล์ : Table } // Close – function 26 Google Apps Script เซอร์วพ ิพส Doucument

2.5.ฉ.) getAttributes() คลาส Body getAttributes() - Method ในคลาส Body และหลายคลาส https://developers.google.com/apps-script/reference/document/body#getAttributes() ใช้จช บัต คณชุ ลตักษณะ(Attributes) ของ Element (ในทนน่ึ นีก้ กค็ อสื Body) โดยจะคสืนค่ลากลตับมาเป็นป Object[] หรือส วตร ถุบทเีท่ ก็กบ Enum Attribute ไวช้ ดยเพีมิทด่ เตมิด ขอช้ 2.6 Enum Attribute หนาช้ 28 ตวตั อยา่ล ง function getAttsBody() { var body = DocumentApp.getActiveDocument().getBody(); var attsBody = body.getAttributes(); for(var att in attsBody){ Logger.log(att + \" : \" + attsBody[att]) ; } } // Close – function ผล Logs [ 01 ] FONT_SIZE : null [ 02 ] ITALIC : null [ 03 ] PAGE_WIDTH : 283.465 [ 04 ] LINK_URL : null [ 05 ] UNDERLINE : null [ 06 ] BACKGROUND_COLOR : null [ 07 ] MARGIN_BOTTOM : 14.1732 [ 08 ] PAGE_HEIGHT : 400.899887517858 [ 09 ] MARGIN_RIGHT : 14.1732 [ 10 ] STRIKETHROUGH : null [ 11 ] MARGIN_LEFT : 14.1732 [ 12 ] FOREGROUND_COLOR : null [ 13 ] BOLD : null [ 14 ] FONT_FAMILY : Sarabun [ 15 ] MARGIN_TOP : 14.1732 2.5.ช.) getAttributes() คลาส Paragraph getAttributes ใช้ชบ่ลอยและเป็ปน Method ในหลายคลาส ฉะน้ตันีนจนงขออธิธบาย getAttributes ในคลาส Paragraph เพนิึ่มธ เตมธิ getAttributes() - Method ในคลาส Paragraph และหลายคลาส https://developers.google.com/apps-script/reference/document/paragraph#getAttributes() เรียร บเรรยี งโดย วสลันต์ล คุคณดิดลกเศวต ([email protected]) 27

ใชจ้ช ับต คุชณลตกั ษณะ(Attributes) ของ Element (ในท่นนึ กน้ี คก็ ือส Paragraph) โดยจะคสนื คาล่ กลบตั มาเปน็ป Object[] หรือส วตร ถุทบ ่ีทเกก็บ Enum Attribute ไวช้ ( ดยเพทิดมี่ เติดมขอช้ 2.6 Enum Attribute หนา้ช 28 ) ตวตั อยา่ล ง function getAttsPara() { var body = DocumentApp.getActiveDocument().getBody() ; // แนบทช้ายดว้ช ยยอ่ม หน้ชาตอม่ ไปนขีึร้ var par = body.appendParagraph('A bold, italicized paragraph.') ; par.setBold(true) ; par.setItalic(true) ; // จบัล Attributes ของย่อม หนช้า var atts = par.getAttributes() ; for (var att in atts) { Logger.log(att + \" : \" + atts[att]) ; } } // Close – function ผล Logs [ 01 ] FONT_SIZE : 8 [ 02 ] ITALIC : true [ 03 ] HORIZONTAL_ALIGNMENT : Left [ 04 ] INDENT_END : 0 [ 05 ] INDENT_START : 0 [ 06 ] LINE_SPACING : 1.15 [ 07 ] LINK_URL : null [ 08 ] UNDERLINE : null [ 09 ] BACKGROUND_COLOR : null [ 10 ] INDENT_FIRST_LINE : 0 [ 11 ] LEFT_TO_RIGHT : true [ 12 ] SPACING_BEFORE : 0 [ 13 ] HEADING : Normal [ 14 ] SPACING_AFTER : 0 [ 15 ] STRIKETHROUGH : null [ 16 ] FOREGROUND_COLOR : null [ 17 ] BOLD : true [ 18 ] FONT_FAMILY : Sarabun 2.6. Enum Attribute https://developers.google.com/apps-script/reference/document/attribute Enum Attribute เป็ปนการแจกแจง(Enumeration) คุชณลตักษณะตล่างๆขององค์รประกอบหรสือวัตตถชุ หรสือ อธธิบายอนกอย่ลางวล่า เปป็นคุชณสมบัตติธของวตัตถชุท่นึถผกกสาหนดไว้ชแลช้ว วล่าเราสามารถเขช้าไปตีต้ันงค่ลาอะไรไดช้บ้ชาง เช่ลน คณชุ สมบัตตธิ BOLD กกค็ สอื คุบณสมบตร พิตรวหนาของอกร ษร เปน็ป ต้นช 28 Google Apps Script เซอรว์พ สพิ Doucument

เราสามารถเรนยกใชช้ Enum Attribute ไดช้จาก DocumentApp.Attribute.[Property] โดย Properties มน ดงัต ต่ลอไปนน้ี Property Type Description BACKGROUND_COLOR Enum The background color of an element (Paragraph, Table, etc) or document. BOLD Enum The font weight setting, for rich text. BORDER_COLOR Enum The border color, for table elements. BORDER_WIDTH Enum The border width in points, for table elements. CODE Enum The code contents, for equation elements. FONT_FAMILY Enum The font family setting, for rich text. FONT_SIZE Enum The font size setting in points, for rich text. FOREGROUND_COLOR Enum The foreground color setting, for rich text. HEADING Enum The heading type, for paragraph elements (for example, DocumentApp.). HEIGHT Enum The height setting, for image elements. HORIZONTAL_ALIGNMENT Enum The horizontal alignment, for paragraph elements (for example, DocumentApp.). INDENT_END Enum The end indentation setting in points, for paragraph elements. INDENT_FIRST_LINE Enum The first line indentation setting in points, for paragraph elements. INDENT_START Enum The start indentation setting in points, for paragraph elements. ITALIC Enum The font style setting, for rich text. GLYPH_TYPE Enum The glyph type, for list item elements. LEFT_TO_RIGHT Enum The text direction setting, for rich text. LINE_SPACING Enum The line spacing setting as a multiplier, for paragraph elements. LINK_URL Enum The link URL, for rich text. The default link style (foreground color, underline) is automatically applied. LIST_ID Enum The ID of the encompassing list, for list item elements. MARGIN_BOTTOM Enum The bottom margin setting in points, for paragraph elements. MARGIN_LEFT Enum The left margin setting in points, for paragraph elements. MARGIN_RIGHT Enum The right margin setting in points, for paragraph elements. MARGIN_TOP Enum The top margin setting in points, for paragraph elements. NESTING_LEVEL Enum The item nesting level, for list item elements. MINIMUM_HEIGHT Enum The minimum height setting in points, for table row elements. PADDING_BOTTOM Enum The bottom padding setting in points, for table cell elements. PADDING_LEFT Enum The left padding setting in points, for table cell elements. PADDING_RIGHT Enum The right padding setting in points, for table cell elements. PADDING_TOP Enum The top padding setting in points, for table cell elements. PAGE_HEIGHT Enum The page height setting in points, for documents. PAGE_WIDTH Enum The page width setting in points, for documents. SPACING_AFTER Enum The bottom spacing setting in points, for paragraph elements. SPACING_BEFORE Enum The top spacing setting in points, for paragraph elements. STRIKETHROUGH Enum The strike-through setting, for rich text. UNDERLINE Enum The underline setting, for rich text. VERTICAL_ALIGNMENT Enum The vertical alignment setting, for table cell elements. WIDTH Enum The width setting, for table cell and image elements. ตวัต อยาล่ ง https://developers.google.com/apps-script/reference/document/attribute โค้ชดตล่อไปน้ีน เม่ืสอนึ รตนั จะพิธมพข์ร อช้ ความ Hello ไว้ชทจน่ึ ดชุ แรกของเอกสาร Google Docs เรยรี บเรยรี งโดย วสันล ต์ล คุณค ดลิด กเศวต ([email protected]) 29

// Define a style with yellow background. var highlightStyle = {} ; highlightStyle[DocumentApp.Attribute.BACKGROUND_COLOR] = '#FFFF00' highlightStyle[DocumentApp.Attribute.BOLD] = true ; // Insert \"Hello\", highlighted. DocumentApp.getActiveDocument().editAsText() .insertText(0, 'Hello\\n') .setAttributes(0, 4, highlightStyle); ผล 2.7. setAttributes() คลาส Paragraph setAttributes(attributes) – Method ในคลาส Paragraph และหลายคลาส https://developers.google.com/apps-script/reference/document/paragraph#setattributesattributes ใชกช้ าส หนด Attributes ใหก้ช ับต Element ในทนึ่นนี้กค็ก อืส Paragraph โดยจะคืนส คล่ากลบตั มาเป็นป ยอ่ล หน้าช ตวัต ทจน่ึ บัต มา เพนยงแตล่ Attributes เปลนึ่ยนไป พารามธิเตอรร์ attributes เปป็น Object[] หรืสอ เป็ปนตวตั แปรวตัตถชุท่ึน Properties ตา่ล งๆตาม Enum Attribute ตวัต อยา่ล ง function setAttsPara(){ var body = DocumentApp.getActiveDocument().getBody(); // เตรียร มตวลั แปร Object วม่างๆรอไวช้ var style = {} ; // ปอ้ป น Item ทีเ่ทร ปน็ป Propertiy : Value ให้ชกบลั ตลัวแปร Object ที่เรท ตรรยี มไวช้ style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT ; style[DocumentApp.Attribute.FONT_FAMILY] = 'Sarabun' ; style[DocumentApp.Attribute.FONT_SIZE] = 12 ; style[DocumentApp.Attribute.BOLD] = false ; style[DocumentApp.Attribute.FOREGROUND_COLOR] = '#0000FF' ; // แนบทาช้ ยดวช้ ยยอ่ม หน้ชา para ลงใน Body ของเอกสาร var par = body.appendParagraph('A paragraph with custom style.'); // กาต หนด Attributes ใหก้ช บัล ยอม่ หนาช้ para body.setAttributes(style) ; } 30 Google Apps Script เซอร์พวสพิ Doucument

ผลหลังต รตันโค้ดช เรรียบเรียร งโดย วสันล ตล์ คุณค ดิลด กเศวต ([email protected]) 31

32 Google Apps Script เซอรพ์วิสพ Doucument

บททีท่ 3 Heading

3.1. setHeading() คลาส Paragraph https://developers.google.com/apps-script/reference/document/paragraph setHeading(heading) – Method ในคลาส Paragraph https://developers.google.com/apps-script/reference/document/paragraph#setheadingheading กาส หนดสไตลร์ยล่อหนช้ามาตรฐานให้ชกัตบยล่อหน้ชา โดยจะคืสนคล่ากลัตบมาเป็ปนย่ลอหน้ชาปัปจจุชบัตน พารามธิเตอร์ร heading ดไผ ดจช้ าก Enum ParagraphHeading (ดยเพมทด่ิี เตมิด ขอ้ช 3.2 Enum ParagraphHeading หนช้า 35) getHeading() – Method ในคลาส Paragraph https://developers.google.com/apps-script/reference/document/paragraph#getheading ใชจ้ช ัตบไสตลย์ร ล่อหนา้ช มาตรฐานของย่อล หนช้า โดยคสืนคล่ากลบัต มาเปป็น Property ใน Enum ParagraphHeading (ดเย พิมที่ด เตมดิ ข้อช 3.2 Enum ParagraphHeading หนาช้ 35) ตวตั อยา่ล ง function example() { var body = DocumentApp.getActiveDocument().getBody() ; body.clear() ; // แนบทา้ช ยด้ชวยยอ่ม หนา้ช + กตาหนดสไตลล์ย่มอหนา้ช เปป็น Heading 1 var par1 = body.appendParagraph(\"Title\") ; par1.setHeading(DocumentApp.ParagraphHeading.HEADING1) ; // แนบทา้ช ยดช้วยยอม่ หน้ชา + กาต หนดสไตลยล์ มอ่ หนช้าเปป็น Heading 2 var par2 = body.appendParagraph(\"SubTitle\") ; par2.setHeading(DocumentApp.ParagraphHeading.HEADING2) ; // แนบทา้ช ยด้วช ยยอม่ หนา้ช + กาต หนดสไตลลย์ อ่ม หนา้ช เปนป็ Nornal text var par3 = body.appendParagraph(\"Text\") ; par3.setHeading(DocumentApp.ParagraphHeading.NORMAL) ; } ผลหลตงั รันต โคดช้ 34 Google Apps Script เซอรวพ์ ิสพ Doucument

3.2. Enum ParagraphHeading Enum ParagraphHeading https://developers.google.com/apps-script/reference/document/paragraph-heading แจงแจงคชุณสมบตตั ิธสไตลย์ร ่ลอหนาช้ มาตรฐาน การเรนยกใชง้ช าน เช่นล DocumentApp.ParagraphHeading.Property Property Type Description NORMAL Enum The heading option for normal text. HEADING1 Enum The highest heading option. HEADING2 Enum The second heading option. HEADING3 Enum The third heading option HEADING4 Enum The fourth heading option. HEADING5 Enum The fifth heading option. HEADING6 Enum The lowest heading option. TITLE Enum The title heading option. SUBTITLE Enum The subtitle heading option. 3.3. setHeadingAttributes() setHeadingAttributes(paragraphHeading, attributes) – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#setHeadingAttributes(ParagraphHeading,Object) ใช้ชกสาหนด Attributes ใหก้ช ัตบสไตลร์ยอล่ หน้ชามาตรฐาน โดยจะคืสนคา่ล กลตบั มาเป็ปนคลาส Body ตวตั เดมธิ พารามิธเตอรร์ – Method ในคลาส Body Name Type Description paragraphHeading ParagraphHeading the heading whose attributes will be set attributes ดมขู อ้ข 3.2 Enum ParagraphHeading หน้ขา 35 Object a map of attributes and the values to set them to ดมขู อ้ข 2.6 Enum Attribute หนา้ข 28 getHeadingAttributes(paragraphHeading) https://developers.google.com/apps-script/reference/document/body#getheadingattributesparagraphheading ใช้ชจตับ Attributes ของสไตลร์ย่ลอหนช้ามาตรฐาน โดยคสืนค่ลากลตับมาเปป็น Object ทน่ึมนสามาชิธกเป็ปน Enum Attributes และ คา่ล ตา่ล งๆ พารามิเธ ตอรร์ paragraphHeading ก็คก ือส Enum paragraphHeading การใชง้ข านเชต่น body.getHeadingAttributes(DocumentApp.ParagraphHeading.HEADING1) เรรียบเรียร งโดย วสัลนต์ล คคณุ ดิลด กเศวต ([email protected]) 35

ผลลพตั ธ์ถร ้ชา Log ดเผ ช่นล Logs [ 01 ] {FONT_SIZE=24, ITALIC=false, HORIZONTAL_ALIGNMENT=Left, INDENT_END=0.0, INDENT_START=0.0, LINE_SPACING=1.15, UNDERLINE=false, BACKGROUND_COLOR=#ffff00, INDENT_FIRST_LINE=0.0, SPACING_BEFORE=20.0, SPACING_AFTER=6.0, STRIKETHROUGH=false, FOREGROUND_COLOR=#00ff00, BOLD=false, FONT_FAMILY=Sarabun, VERTICAL_ALIGNMENT=Center} ตวตั อยา่ล ง function HeadingAttributes() { var myHeading1 = {} ; myHeading1[DocumentApp.Attribute.FONT_SIZE] = 24 ; myHeading1[DocumentApp.Attribute.FONT_FAMILY] = \"Sarabun\" ; var myHeading2 = {} ; myHeading2[DocumentApp.Attribute.FONT_SIZE] = 16 ; myHeading2[DocumentApp.Attribute.FONT_FAMILY] = \"Sarabun\" ; myHeading2[DocumentApp.Attribute.FOREGROUND_COLOR] = \"#555555\" ; var myNormal = {} ; myNormal[DocumentApp.Attribute.FONT_SIZE] = 12 ; myNormal[DocumentApp.Attribute.FONT_FAMILY] = \"Sarabun\" ; myNormal[DocumentApp.Attribute.FOREGROUND_COLOR] = \"#505050\" ; myNormal[DocumentApp.Attribute.SPACING_BEFORE] = 5 ; myNormal[DocumentApp.Attribute.SPACING_AFTER] = 0 ; var body = DocumentApp.getActiveDocument().getBody() ; body.setHeadingAttributes(DocumentApp.ParagraphHeading.HEADING1, myHeading1) .setHeadingAttributes(DocumentApp.ParagraphHeading.HEADING2, myHeading2) .setHeadingAttributes(DocumentApp.ParagraphHeading.NORMAL, myNormal) ; } 36 Google Apps Script เซอรว์พ สิพ Doucument

บททที่ 4 Elements

4.1. Elements Elements คอน อะไร ? เอกสาร Google Docs ประกอบไปด้ชวย Elements(วตร ถบุธาต)ุบ ตาล่ งๆมากมาย เช่นล ListItem, Paragraph และ Table เป็ปนตนช้ ซึน่งทุชกตตัวกค็ก ือส Elements ภายในเอกสาร Elements ลกกู หรอน Child elements เม่สนึือเราจตับไปทน่ึ Element สตักตัตวหนนึ่งในเอกสาร Element ตัวต นตั้ีนนจะมน Elements ย่ลอยๆขช้างในอนก เชล่น เมืสนึ่อจตับทึ่น Body ลผกๆของ Body กก็คืสอ Paragraph, ListITem, Table, TableOdContents เปป็นต้ชน ซ่ึนงเราเรนยกว่ลา Elements ย่อล ยๆขา้ช งในนวนี้ าล่ Elements ลกมู หรือส Child elements 4.2. Interface Element Interface Element – Interface ของเซอร์วล ิสด Document https://developers.google.com/apps-script/reference/document/element Elements ตาล่ งๆมน Methods กลลมชุ่ หนนงึ่ ทน่ึซาส้ีน กตัน ซงนึ่ เราสามารถจับต มามตดั รวมกนตั (Inherit หรือส สบืส ทอดส่งนิธึ ทึ่นซ้ีนสากันต ออกมา) กลายเปนป็ Interface Element หรืสอ เป็ปนกลต่มุบ Methods Methods ใน Interface Element ยกตวตั อยาล่ งเช่ลน getAttributes(), Method ตระกผล as เชนล่ asParagraph() เปนป็ ต้นช หมายเหตุบ 1 : มสน ิึ่ธนงทึน่คลชา้ ยกตันกค็ก ืสอ คลาส Element(ตามลิธงคด์ร ้ชานลา่ล ง) แตล่เปนป็ วัตตถุชหรอสื คลาสในเซอร์รวธิส XML เซอรพว์ ิพส XML https://developers.google.com/apps-script/reference/xml-service เปน็ป บริกธ ารทนึใ่ ชช้ วิเธ คราะหร์ สาส รวจ และโปรแกรม ในการสราช้ งเอกสาร XML คลาส Element (ในเซอรว์ล ิสด XML) https://developers.google.com/apps-script/reference/xml-service/element เปน็ป XML ของ Element node หมายเหตุบ 2 : ภาษา XML มโน ครงสรา้ช งเหมืสอนกบัต HTML มนแทก็กเปดปิ แทกก็ ปดปิ แตล่ XML เราสามารถ สรา้ช งแท็กก และกสาหนดโครงสร้ชางของข้อช มลผ ไดเช้ อง ตา่ล งจาก HTML ทนึแ่ ท็กกถกผ กหนดตายตัตว ตวตั อยาล่ ง XML Tutorial https://www.w3schools.com/xml/ <?xml version=\"1.0\" encoding=\"UTF-8\"?> <note> <to>Tove</to> <from>Jani</from> <heading>Reminder</heading> <body>Don't forget me this weekend!</body> </note> แตล่ล ะแทก็ก ทึเน่ ราสร้ชางเรนยกวล่า โหนด(node) เชน่ล โหนด Note เปน็ป ตน้ช 38 Google Apps Script เซอรพว์ พิส Doucument

ยกตัธวอย่สาง การดกชู นิวดของ Elements ใน Body องคป์ร ระกอบในสว่ล น Body ในเอกสาร Google Docs มตน ามภาพ โคช้ดต่ลอไปนีน้ จบตั Elements ใน Body ของเอกสาร Log ดวผ า่ล มชน นดธิ เปปน็ อะไรบา้ช ง function testElem() { var body = DocumentApp.getActiveDocument().getBody(); var elemInBody = body.getNumChildren(); for(var x = 0 ; x < elemInBody ; x++){ // วนหลปย Log ชนดิด Elements ทรท่จี บัล มา Logger.log(body.getChild(x).getType()) ; }; } ผล [ 01 ] PARAGRAPH // ยอ่ม หนช้าวมา่ ง [ 02 ] PARAGRAPH [ 03 ] TABLE [ 04 ] LIST_ITEM [ 05 ] LIST_ITEM [ 06 ] LIST_ITEM [ 07 ] PARAGRAPH 4.3. getNumChildren() getNumChildren() - Method ในคลาส ContainerElement https://developers.google.com/apps-script/reference/document/container-element#getnumchildren ใช้จช ตับจสานวนของ Elements ลมกู โดยจะคสนื คาล่ กลตับมาเป็ปนเลขจสานวนเต็มก คลาส ContainerElement https://developers.google.com/apps-script/reference/document/container-element Element ทนึเ่ ปปน็ ตวตั เกก็บ Elements อึ่สนืนๆ (เรยน กวาล่ Element บรรจุภช ณัต ฑกร์ กไ็ ด)้ช เรีรยบเรียร งโดย วสนลั ตล์ คณุค ดลิด กเศวต ([email protected]) 39

ตวธั อย่สาง ให้ใช ส่อล ะไรลงไปในเอกสาร Google Docs บา้ช งจากน้นีตัน จนงรตันโคด้ช ต่ลอไปนี้น var body = DocumentApp.getActiveDocument().getBody(); var elemInBody = body.getNumChildren(); // ถ้ชา Log ดจย ะได้ผช ลลัลพธลเ์ ข่นม 7 (เปน็ป จาต นวนของ Elements) เปนป็ ตน้ช 4.4. จับจ และดกูชนิวดของ Elements (คลาส Body) getChild() เปน็ป Method ในหลายคลาส หลกัต ๆกค็ก ือส ใช้ชจตบั Child elements เชล่น getChild(name) – Method ในคลาส Element https://developers.google.com/apps-script/reference/xml-service/element#getchildname getChild(name, namespace) – Method ในคลาส Element https://developers.google.com/apps-script/reference/xml-service/element#getchildname,-namespace getChild(childIndex) – Method ในคลาส Paragraph https://developers.google.com/apps-script/reference/document/paragraph#getchildchildindex getChild(childIndex) – Method ในคลาส Body *** https://developers.google.com/apps-script/reference/document/body#getchildchildindex ใชช้จตับ Child elements ใน Body โดยคสืนค่ลากลตับมาเป็ปน คลาส Element พารามธิเตอรร์ childIndex เปน็ป เลขดรรชลน าส ดตับ (เรธ่มึนิ จาก 0 getType() – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body#gettype ใชชจ้ ับล ชนิดด ของ Elements โดยจะคคนื คาม่ กลลับมาเปนป็ Enum ElementType ตวตั อยาล่ ง function getChildElems() { var body = DocumentApp.getActiveDocument().getBody() ; // จบัล ไปท่รีท Child element ตัลวแรกใน Body var firstChild = body.getChild(0) ; // ถชา้ Element เปน็ป ย่มอหนช้า(PARAGRAPH) ให้ใช สข่ม ชอ้ ความ … ลงไปแทน if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText(\"This is the first paragraph.\") ; } } ผล หลงร รนร กอ่ต นรนร 40 Google Apps Script เซอร์พวิพส Doucument

4.5. Enum ElementType Enum ElementType https://developers.google.com/apps-script/reference/document/element-type เป็นป ตัวต แจกแจงชนดิธ ของ Elements การใชง้ช านกค็ก สอื DocumentApp.ElementType.(Property) Property Type Description BODY_SECTION Enum The type corresponding to the Body element. COMMENT_SECTION Enum The type corresponding to the CommentSection element. DOCUMENT Enum The type that corresponds to the root of the document. EQUATION Enum The type corresponding to the Equation element. EQUATION_FUNCTION Enum The type corresponding to the EquationFunction element. EQUATION_FUNCTION_ Enum The type corresponding to the element. ARGUMENT_SEPARATOR EquationFunctionArgumentSeparator EQUATION_SYMBOL Enum The type corresponding to the EquationSymbol element. FOOTER_SECTION Enum The type corresponding to the FooterSection element. FOOTNOTE Enum The type corresponding to the Footnoteelement. FOOTNOTE_SECTION Enum The type corresponding to the FootnoteSection element. HEADER_SECTION Enum The type corresponding to the HeaderSection element. HORIZONTAL_RULE Enum The type corresponding to the HorizontalRule element. INLINE_DRAWING Enum The type corresponding to the InlineDrawing element. INLINE_IMAGE Enum The type corresponding to the InlineImage element. LIST_ITEM Enum The type corresponding to the ListItem element. PAGE_BREAK Enum The type corresponding to the PageBreak element. PARAGRAPH Enum The type corresponding to the Paragraph element. TABLE Enum The type corresponding to the Table element. TABLE_CELL Enum The type corresponding to the TableCell element. TABLE_OF_CONTENTS Enum The type corresponding to the TableOfContents element. TABLE_ROW Enum The type corresponding to the TableRow element. TEXT Enum The type corresponding to the Text element. UNSUPPORTED Enum The type corresponding to UnsupportedElement. Unsupported elements represent document portions that do not support scripting. เรยีร บเรีรยงโดย วสลันตล์ คคณุ ดลิด กเศวต ([email protected]) 41

4.6. ระบุชบ นวดิ ELement ด้รวย Method ตระกูกล As เม่ึสืนอจัตบ Child elements แลช้ว หากจะเขช้าไปทสาอะไรตล่อ เราต้ชองระบุช Element ตัตวน้ีนัตนตามชนิธดด้ชวย Method ตระกผล as เช่ลน asParagraph(), asTable() หรืสอ asListItem() เป็ปนตช้น จากน้ีัตนนเราจะสามารถใชช้ Method ทตึ่น รงกบัต ชนธิดของ Element เพ่ึสือน ทสาอะไรตอล่ กว็ก ่ลาไป asParagraph() - Method ใน Interface Element https://developers.google.com/apps-script/reference/document/element#asparagraph คืนส คาล่ Element ทจน่ึ บัต มาได้เช ปน็ป Paragraph เชนล่ function getChildElems() { var body = DocumentApp.getActiveDocument().getBody() ; var childsCount = body.getNumChildren() ; for(var x = 0 ; x < childsCount ; x++) { // วนหลปย จบลั ทรลี ะ Element ไปใส่ม if/else var child = body.getChild(x).copy() ; // ถาข้ เป็ปนย่อต หนข้า + ยอ่ต หน้ขาไมต่วต่าง if ( child.getType() == DocumentApp.ElementType.PARAGRAPH && child.asParagraph().getText() != \"\") { var para = child.asParagraph() ; // ระบบุ Element เปนป็ Paragraph body.appendParagraph(para).appendText('(ตรวก๊กอปปป)') ; // ถข้าเปน็ป ตาราง } else if ( child.getType() == DocumentApp.ElementType.TABLE) { var table = child.asTable() ; // ระบบุ Element เปปน็ Table var rowAdd = table.getRow(0).copy() ; // กอก็ ปป้ีปแถวแรก body.appendTable(table).appendTableRow(rowAdd) ; // แนบแถวแรกทีรทก่ กอ๊ ปปปี้ } // Close – else if } // Close – for } // Close - function ผล หลรง กอต่ น 42 Google Apps Script เซอรพ์วสพิ Doucument

ผลหลตังรนัต Logs [ 01 ] PARAGRAPH [ 02 ] TABLE [ 03 ] LIST_ITEM [ 04 ] LIST_ITEM [ 05 ] LIST_ITEM [ 06 ] PARAGRAPH หมายเหตบุ ดรผ ายละเอนยดเพิ่นมธึ เตมธิ ไดจ้ช ากลธิงคตร์ ลอ่ ไปนีน้ getChild – Method ในคลาส ContainerElement/Element https://developers.google.com/apps-script/reference/document/container-element#getchildchildindex https://developers.google.com/apps-script/reference/xml-service/element#getchildname ใช้ชจบัต Element ตามดรรชนนลสาดบัต เชน่ล getChild(0) เปปน็ ต้ชน คสนื ค่ลากลัตบมาเปน็ป Element getNumChildren() – Method ในคลาส ContainerElement https://developers.google.com/apps-script/reference/document/container-element#getnumchildren ใช้จช ตบั จาส นวน Elements คนสื คาล่ กลัตบมาเป็นป เลขจาส นวนเตม็ก 4.7. findElement() findElement(elementType, from) – Mehod ในหลายคลาส Body และอีรกหลายคลาส https://developers.google.com/apps-script/reference/document/list-item.html#findelementelementtype,-from ใชชค้ น้ช หาเนสืน้อี หาใน Element แบบเจาะจงชนธิด โดยจะคืสนค่าล กลตบั มาเปป็นคลาส RangeElement พารามิธเตอรร์ Name Type Description elementType ElementType the type of element to search for from RangeElement the search result to search from เรยีร บเรรยี งโดย วสลนั ตล์ คุคณดลิด กเศวต ([email protected]) 43

ตวัต อยาล่ ง function example() { var body = DocumentApp.getActiveDocument().getBody() ; // สรา้ช งตัวล แปร 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 ; } } } ผล - หลัตงรตันโคช้ดย่ลอหน้ชาแรกท่ึนใช้ชสไตล์รยล่อหนช้า Heading1 ข้ชอความจะถผกเปลึ่นยนเปป็น This is the first header 44 Google Apps Script เซอรพ์วพสิ Doucument

บททที่ 5 เคอรเ์ร ซอร์ร

5.1. getCursor() getCursor()– Method ในคลาส Document https://developers.google.com/apps-script/reference/document/document#getcursor ใช้ชจัตบเคอร์รเซอรใร์ นเอกสารทน่กึ าส ลตังทสางานดว้ช ย โดยจัตบได้ชเฉพาะของยผสเซอรร์ทน่ึรัตนสครธิปตร์ และเป็ปนสครธิปต์ร ฝัปงในไฟล์ร (ถผกหลอ่ หชุ้ม หรสือ bound ← คลดิกเพอ่คทีื ดยรายละเอรียด) โดยจะจะคืสนคล่ากลัตบมาเป็ปนคลาส Position แตล่ถช้า จตับไมล่ไดจ้ช ตคั สืนคา่ล กลบตั มาเปปน็ null คลาส Position https://developers.google.com/apps-script/reference/document/position.html ตาส แหน่ลงอา้ช งองธิ ในเอกสาร Google Docs เปป็นแบบอ้าช งอธิงจาก Element ตวัธ อยา่ส ง : แทรกขร้อความ ณ ตตาแหน่งส เคอร์รเซอร์ร โคด้ช ต่ลอไปนี้น รัตนจากโปรเจ็กค Google Apps Script จะคาช้ ง วธิธ รน ตันตช้องสรา้ช งเมนผ แลช้วรันต จากเมนผ ทัตน้ีงนน้ีเพนืสึ่อ ท่ึนจะจตับตสาแหนล่งของเคอรร์เซอร์รไดช้ ถช้ารตันจาก Google Apps Script เคอร์รเซอร์รไม่ลแอ็กคทนฟทน่ึเอกสาร Google Docs กล่อนรตัน ให้รคลวิกแทรกในย่สอหน้ราหรนอขร้อความไวร้ จากนี้ัตนนจนงรัตนสคริธปตร์จากเมนผ แต่สถ้ราคลวิกเลนอกไว้รท่ขีอื ภาพ จะปรากฎหนช้าต่ลางมาแจช้งวล่า Cannot insert text here ก็กคสือ ไม่ลสามารถแทรกขช้อความไดช้ (เพราะไม่ลมน เคอรร์เซอร)ร์ function onOpen() { DocumentApp.getUi().createMenu('My Menu') .addItem('Insert someting at cursor' , 'insertAtCursor') .addToUi() ; } function insertAtCursor(){ // จบัล ตาต แหนมง่ ของเคอร์ลเซอรล์ ไดกช้ ลบัล มาเปปน็ คลาส Postion var cursor = DocumentApp.getActiveDocument().getCursor() ; // ถ้ชาจบลั เซอร์ไล ดช้ - แทรกขอช้ ความ ณ ตตาแหน่มงของเคอรล์เซอรล์ if (cursor) { // if/else #1 var element = cursor.insertText('ಠ‿ಠ') ; if (element) { // if/else #2 element.setBold(true); // ทตาตลัวหนา } else { DocumentApp.getUi().alert('Cannot insert text here.'); } // Close - if/else #2 // ถชา้ จบัล เคอร์ลเซอร์ลไมม่ได้ช - แสดงหน้าช ตา่ม งแจชง้ Error // Close - if/else #1 } else { DocumentApp.getUi().alert('Cannot find a cursor.'); } } 46 Google Apps Script เซอร์พวสพิ Doucument

5.2. setCursor(), newPosition() setCursor(position) – Method ในคลาส Document https://developers.google.com/apps-script/reference/document/document#setcursorposition ใชช้กสาหนดตสาแหนง่ล ของเคอรร์เซอร์ร ณ ตาส แหนง่ล ท่นรึ ะบุชใน postion (เป็ปน New postion) newPosition(element, offset) – Method ในคลาส Document https://developers.google.com/apps-script/reference/document/document#newpositionelement,-offset สรา้ช งวัตตถชุ Position ตวร ใหมต่ โดยอ้าช งอธิงจากจาก Element ในเอกสาร Name Type Description element Element Element ทจ่ีทร ะใช้บช รรจุควลัตถคุ Postion ตวร ใหมต่ ซข่งที สามารถเป็ปนได้ชท้ัึขงล Text offset Integer หรคือ Paragraph สสาหรบร Element ทเที่ ปปน็ Text เปนป็ ตวลั เลขจาต นวนตลวั อกัล ษรก่มอนตาต แหนม่ง สสาหรรบ Elements อนีรทื่ ๆ เปปน็ ตลัวเลขจาต นวน Child elements กอม่ น ตาต แหน่งม ภายในวัลตถบคุ รรจุคภัลณฑล์ตวลั เดยรี วกนัล ตวตั อยาล่ ง function setCurAtNewPos() { var doc = DocumentApp.getActiveDocument() ; var paragraph = doc.getBody().appendParagraph('My new paragraph.') ; // สร้าช งวัลตถคุ Postion ณ ตตาแหนงม่ หลงัล ตัลวอกลั ษรทท่รี 6 ของยอม่ หนา้ช var position = doc.newPosition(paragraph.getChild(0), 6) ; // กาต หนดตาต แหนง่ม ใหช้กบัล เคอร์เล ซอร์ล doc.setCursor(position) ; } ผล – มยน ล่อหนาช้ ตอ่ล ทาช้ ยเอกสาร โดยเคอรร์เซอรจร์ ะปรากฎอย่ลหผ ลังต ตวตั อตักษรทน่ึ 6 (หลงตั w) เรยีร บเรีรยงโดย วสลันต์ล คุณค ดิดลกเศวต ([email protected]) 47

48 Google Apps Script เซอรพ์วิสพ Doucument

บททที่ 6 Selection

6.1. getSelection(), getRangeElements(), getElement() getSelection() - Method ในคลาส Document https://developers.google.com/apps-script/reference/document/document#getselection จตับสึธิน่งทน่ึเลืสอกโดยยผสเซอรร์ ในเอกสารทนึ่แอ็กคทฟน อยลผ่ คสืนค่าล กลัตบมาเปป็นคลาส Range แตล่ถ้ชาไม่ลเลืสอกอะไรไวช้ จะคสนื คลา่ null คลาส Range https://developers.google.com/apps-script/reference/document/range.html เรนช้ จร์ของ Element ในเอกสาร โดยส่นิงธึ ทนึ่ยสผ เซอรเ์ร ลอืส กกก็คอสื Range getRangeElements() - Method ในคลาส Range https://developers.google.com/apps-script/reference/document/range.html#getrangeelements ใชช้จัตบ Elements ทนี้ัตงหมดใน Range (Element ท่นึถผกเลสือก) แม้ชจะเปป็นบางสล่วนของ Element ทนึ่ถผก เลสือก ยกตตัวอยาล่ งการเลืสอกบางส่ลวนของย่ลอหนช้า โดย Method นนี้ จะคืสนค่ลากลัตบมาเป็ปน RangeElement[] หรืรอ อารเยท์พ ี่ทบรรจไุบ ปด้ขวย คลาส RangeElement คลาส RangeElement https://developers.google.com/apps-script/reference/document/range-element.html ตวัต ห่อล Element ทถ่ึน กผ เลสือก ตงตันี้ แตลจ่ ดุช เร่มนธึิ และจบครอบ Element เชลน่ ถช้าเลือส ก 1 ตวัต อกัต ษรในย่อล หนช้า RangeElement กกค็ อืส ยอล่ หนช้าทังีต้น กอ้ช น getElement() - Method ในคลาส RangeElement https://developers.google.com/apps-script/reference/document/range-element#getelement ใชจช้ ตับ Element ในวตตั ถุช RangeElement isPartial() - Method ในคลาส RangeElement https://developers.google.com/apps-script/reference/document/range-element.html#ispartial ใชเช้ ช็คก วา่ล RangeElement ทน่เึ ลอืส ก ถกผ เลอืส กท้ัีตนงก้ชอน หรืสอบางสวล่ นของขอช้ ความ(Text element) โดยจะ คนสื คาล่ กลัตบมาเปน็ป Boolean จดชุ เร่ิมนึธ ตน้ช และจุดช จบของ RangeElement สามารถจตบั ไดชโ้ ดยใช้ช Method getStartOffset() และ getEndOffsetInclusive() ตามลสาดัตบ getStartOffset() - Method ในคลาส RangeElement https://developers.google.com/apps-script/reference/document/range-element.html#getStartOffset() ตสาแหน่ลงจุชดเรนธ่ิึมตช้นของ RangeElement (Text element) อธธิบายไว้ชขช้างบน Method นี้นคืสนคล่ากลัตบมา เปนป็ เลขจสานวนเต็มก ของตาส แหนล่ง และคนสื ค่ลากลตับมาเปน็ป -1 หากเปป็นอยาล่ งอนนึ่สื getEndOffsetInclusive() - Method ในคลาส RangeElement https://developers.google.com/apps-script/reference/document/range-element.html#getEndOffsetInclusive() ตสาแหนง่ล จุชดจบของ RangeElement (Text element) อธิธบายไวข้ช าช้ งบน Method นคนี้ สนื ค่าล กลตบั มาเปปน็ เลขจสานวนเตกม็ ของตสาแหนล่ง และคืสนค่าล กลตับมาเปน็ป -1 หากเป็ปนอยล่างอสืึ่นน 50 Google Apps Script เซอรว์พ ิสพ Doucument