ตวธั อยาส่ งท่ือีข 1 function catchElem() { // กมอ่ นรนัล โคช้ดใหช้เลคือก ไว้สช ลักตวัล อลักษรหนีทง่ข ในยอม่ หน้าช เปน็ป อยา่ม งนชอ้ ย หรืคอ เลอืค กตารางกไ็ก ด้ช var selection = DocumentApp.getActiveDocument().getSelection(); // Logger.log(selection); // พมดิ พล์ : Range var rangeElems = selection.getRangeElements() ; // Logger.log(rangeElems); // พมดิ พ์ล : [RangeElement, RangeElement] // ( กรณีรเลืคอกบางส่มวนของ 2 ยอม่ หนช้าไว้ช ) var elemInRangeElems = rangeElems[0].getElement().getType() ; // Logger.log(elemInRangeElems); // พมดิ พล์ชนดดิ ของ Element // เชมน่ TEXT / TABLE_CELL var text = selection.getRangeElements()[0].getElement().getText(); Logger.log(text); // พมิด พ์ล : ขอ้ช ความทัง้ึขล ยมอ่ หนา้ช ทีท่รถยกเลือค กอยย่ม } กลอ่ นรันต โคด้ช เลสือกข้ชอความบางสลว่ นในยอ่ล หนช้าไว้ช ผล – หลตงั รตันโคด้ช Logs [ 01 ] Range [ 02 ] [RangeElement] [ 03 ] TEXT // ถ้าช เลอืค กตารางไว้ช ขนขึ้ เปปน็ TABLE_CELL [ 04 ] ยอต่ หนข้านั้รท ใชขเ้ ป็ปนตวร อยตา่ งสสาหรรบอธบพิ าย Google Apps Script เซอรวพ์ สิพ Document ตวัธ อยาส่ งท่ืีขอ 2 function Example2() { var selection = DocumentApp.getActiveDocument().getSelection(); var Elements = selection.getRangeElements(); Logger.log(Elements); Elements.forEach(function(element,i){ Logger.log(element+' '+i+' type : ' +element.getElement().getType()); }); } เรรยี บเรีรยงโดย วสัลนต์ล คคุณดิลด กเศวต ([email protected]) 51
ผล – กอ่ล นรันต โคด้ช เลอสื กไวช้หลายอยาล่ ง ทงตั้ีน ตารางและยล่อหนช้า Logs [ 01 ] [RangeElement, RangeElement, RangeElement, RangeElement, RangeElement, RangeElement, RangeElement, RangeElement, RangeElement] [ 02 ] RangeElement 0 type : PARAGRAPH [ 03 ] RangeElement 1 type : TABLE [ 04 ] RangeElement 2 type : PARAGRAPH [ 05 ] RangeElement 3 type : TABLE [ 06 ] RangeElement 4 type : PARAGRAPH [ 07 ] RangeElement 5 type : TABLE [ 08 ] RangeElement 6 type : PARAGRAPH [ 09 ] RangeElement 7 type : LIST_ITEM [ 10 ] RangeElement 8 type : LIST_ITEM getType() - Method ใน Interface Element https://developers.google.com/apps-script/reference/document/element#gettype ใชจช้ ตับชนิธดของ ELement คสนื คา่ล กลับต มาเป็นป Enum ElementType Enum ElementType – แจกแจงชนดิด ของ Elements https://developers.google.com/apps-script/reference/document/element-type.html ตวธั อย่าส งท่ขีอื 3 function Example3() { var selection = DocumentApp.getActiveDocument().getSelection() ; // จบลั Element ตัลวแรกทีทเ่ร ลอคื ก var rangeElement = selection.getRangeElements()[0] ; Logger.log('Element type: ' + rangeElement.getElement().getType()); // ถชา้ ถยกเลอคื กบางสว่ม น if (rangeElement.isPartial()) { Logger.log('The character range begins at '+ rangeElement.getStartOffset()); Logger.log('The character range ends at '+ rangeElement.getEndOffsetInclusive()); // ถา้ช ถยกเลคือกทึข้ลัง Element } else { Logger.log('The entire range element is included.'); } 52 Google Apps Script เซอร์วพ ิพส Doucument
รนัธ ครธัง้นื ทอ่ืขี 1 : กลอ่ นรันต โคด้ช เลสือกข้ชอความบางส่ลวนในย่ลอหนช้าไว้ช ผลการรนตั ครตันี้งทน่ึ 1 [ 01 ] Element type: TEXT [ 02 ] The character range begins at 18 [ 03 ] The character range ends at 25 รนัธ ครง้ืธัน ทีขื่อ 2 : กอ่ล นรนตั โคด้ช เลอืส กบางสวล่ นของเซลลร์ในตารางไวก้ช อ่ล น ผลการรนัต ครีนั้ตงทึน่ 2 [ 01 ] Element type: TABLE_CELL [ 02 ] The entire range element is included. เรรียบเรรียงโดย วสันล ต์ล คุคณดิลด กเศวต ([email protected]) 53
6.2. Methods ตระกูลก Insert – ยาร้ ยไป Element insertParagraph(childIndex, paragraph) https://developers.google.com/apps-script/reference/document/body#insertparagraphchildindex,-paragraph แทรกยอ่ล หนา้ช ณ ตสาแหนงล่ ทก่ึน สาหนด พารามิธเตอรร์ Name Type Description childIndex Integer the index at which to insert paragraph Paragraph the paragraph to insert Class Paragraph https://developers.google.com/apps-script/reference/document/paragraph deleteText(startOffset, endOffsetInclusive) https://developers.google.com/apps-script/reference/document/text#deletetextstartoffset,-endoffsetinclusive พารามิเธ ตอรร์ Name Type Description startOffset Integer the character offset of the first character to delete endOffsetInclusive Integer the character offset of the last character to delete ตวัต อยา่ล ง function example1() { var body = DocumentApp.getActiveDocument().getBody() ; // แทรก 2 ยมอ่ หนช้า โดยมเีร สช้น 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. // ลบข้ชอความ ‘n editAsText’ body.editAsText().deleteText(14, 25) ; } ผล 54 Google Apps Script เซอรวพ์ พิส Doucument
บทท่ที 7 Text
7.1. คลาส Text คลาส Text https://developers.google.com/apps-script/reference/document/text Element ท่นึบรรจดชุ ช้วย ข้ชอความ หรืสอ Text โดย Text ทกุช ตัตวทน่ึอยผ่ลในเอกสารถผกบรรจุชใน Element ชนิธด Text Text เป็นป สลว่ นประกอบเล็กกๆ ภายในองคป์ร ระกอบอึนืสน่ ๆมากมาย เชน่ล เป็นป สล่วนประกอบของ Document, Equation, ListItem หรอืส Paragraph เป็นป ต้นช แตต่ล ัตวมตันเอง(Text) ไมส่ล ามารถบรรจอชุ ะไรไดเช้ ลย เราใชร้ Method ของคลาส Text ไดรเ้ ยอะมาก อะไรทีขม่ือ ีข Text ใชร้ได้รหมด 7.2. editAstext(), insertText() editAsText() – Method ในคลาส Body https://developers.google.com/apps-script/reference/document/body.html#editastext แกชไ้ ข Element ตวัต นนั้ีตนในแบบ Text โดยจะคืนส คาล่ กลตบั มาเปป็น Text แตล่ใชไช้ มไล่ ดก้ช บัต Element ประเภท Non-text อยา่ล ง InlineImage และ HorizontalRule insertText(text) - Method ใน คลาส Position https://developers.google.com/apps-script/reference/document/position#inserttexttext insertText(offset, text) - Method ใน คลาส Text https://developers.google.com/apps-script/reference/document/text#inserttextoffset,-text ใช้ชแทรกข้อช ความ ณ ตสาแหนลง่ ท่นึระบุช ซน่ึงเป็นป ระยะออฟเซต็ก ตวัต อตักษร Name Type Description offset Integer the character offset at which to insert text String the text to insert ตวัต อยา่ล ง function example() { var body = DocumentApp.getActiveDocument().getBody() ; // แกไช้ ข Body แบบ Text var text = body.editAsText() ; // แทรก Text ตรงๆ ลงใน Body จะ Error // body.insertText(0, 'Inserted text.\\n') ; // แทรกขอช้ ความ Inserted text. ททีจ่ร ดคุ แรก (0) + กด Enter text.insertText(0, 'Inserted text.\\n') ; // แนบทชา้ ยดว้ช ย Text text.appendText('\\nAppended text.') ; // ระบายสรี เรทิีด่มจาก ตัวล แรก ถงข แบง่ม ครง่ทขี Text ใน Body สรีแดง text.setForegroundColor(0, text.getText().length / 2, '#FF0000') ; } 56 Google Apps Script เซอร์พวสพิ Doucument
ผล 7.3. deleteText() deleteText(startOffset, endOffsetInclusive) - Method ใน คลาส Text https://developers.google.com/apps-script/reference/document/text#deletetextstartoffset,-endoffsetinclusive ใชลช้ บข้ชอความแบบเปน็ป เรช้นจ์ร พารามธิเตอรร์ Name Type Description startOffset Integer the character offset of the first character to delete endOffsetInclusive Integer the character offset of the last character to delete ตวัต อยาล่ ง function example() { var body = DocumentApp.getActiveDocument().getBody() ; // แทรก 2 ยอ่ม หนช้า ขึัลนข้ โดยเสชย้ Horizontal rule // ยม่อหน้าช ทที่ร 2 body.insertParagraph(0, \"An editAsText sample.\") ; // เสช้น hr body.insertHorizontalRule(0) ; // ยอ่ม หน้าช แรก body.insertParagraph(0, \"An example.\") ; // ลตลัวอกัล ษร “n editAsText” ในย่อม หนาช้ ทีรท่ 2 body.editAsText().deleteText(14, 25) ; } ผล เรยรี บเรียร งโดย วสันล ต์ล คุคณดดิลกเศวต ([email protected]) 57
7.4. replaceText() Replacing text https://developers.google.com/apps-script/guides/docs#replacing_text มาตรฐาน RE2 https://github.com/google/re2 replaceText(searchPattern, replacement) - Method ในคลาส Text https://developers.google.com/apps-script/reference/document/text#replacetextsearchpattern,-replacement ใชคช้ น้ช หาและแทนทึ่ขน อ้ช ความ โดยจะคืนส คาล่ กลบัต มาเปปน็ Element เดมิธ พารามเิธ ตอร์ร Name Type Description searchPattern String the regex pattern to search for replacement String ( ขอ้ช ความธรรมดา หรคือ Regular Expression มาตรฐาน RE2 ) ตวธั อย่าส ง ขช้อความททีรจ่ ะมาแทนทที่ร var body = DocumentApp.getActiveDocument().getBody(); // ล้าช งยอ่ม หนช้าที่มรท ีรขอช้ ความ Apps Script อยดม่ย วช้ ย // ใหเช้ หลคือเพีรยงขอช้ ความ Apps Script เทาม่ น้นลัึข body.replaceText(\"^.*Apps ?Script.*$\", \"Apps Script\"); ตวธั อยาส่ งทือีข่ 2 โคดช้ ต่ลอไปน้ีน ใชค้ช ชน้ หาขช้อความ เช่ลน {name} จากน้ีนันต แทนท่ดนึ ชว้ ยคาล่ ในตวตั แปรแบบวตตั ถชุ เช่นล instructor.name คาล่ กก็คสอื Wasan Khunnadiloksawet เปน็ป ตน้ช ตวัต อยาล่ งโคช้ดนนี้ มกัต เอาไปใชทช้ สา MailMerge // พมิด พล์ย่อม หนช้า สตาหรลับทดสอบแทนทที่รขอช้ ความ function createParas() { var body = DocumentApp.getActiveDocument().getBody(); // พมดิ พยล์ ่มอหน้าช ท่ทรมี รีข้อช ความต่าม งๆลงไป รวมแลว้ช มีร 4 ยอ่ม หน้ชา body.appendParagraph('{name}') ; body.appendParagraph('{address}') ; body.appendParagraph('{city} {province}') ; body.appendParagraph('{zip}') ; } // มีรตอ่ม 58 Google Apps Script เซอร์พวสิพ Doucument
// ตอม่ function Search_n_Replace() { var body = DocumentApp.getActiveDocument().getBody(); var instructor = { name: 'Wasan Khunnadiloksawet' , address: '1 Moo 2 Nongpha' , city: 'Nongphai' , province: 'Petchaboon' , zip: 67140 }; body.replaceText('{name}', instructor.name) .replaceText('{address}', instructor.address) .replaceText('{city}', instructor.city) .replaceText('{province}', instructor.state) .replaceText('{zip}', instructor.zip) ; } เรยีร บเรีรยงโดย วสนัล ต์ล คณุค ดดลิ กเศวต ([email protected]) 59
60 Google Apps Script เซอรพ์วิสพ Doucument
บททีท่ 8 ภาพ
8.1. ใสสภ่ าพลงในตตาแหนส่ง Cursor Insert Inline Image in a Google Document https://ctrlq.org/code/20078-insert-image-in-google-document insertInlineImage(image) – Method ในคลาส Position https://developers.google.com/apps-script/reference/document/list-item.html#insertinlineimagechildindex,-image สรชา้ งและแทรกภาพ InlineImage ณ ตสาแหนง่ล วตัต ถชุ Position พารามเิธ ตอรร์ image ก็คก สอื Blob ของภาพ insertImage(childIndex, image) – Method ในคลาส Body สร้ชางและแทรกภาพ InlineImage ณ ตาส แหนง่ล ChildIndex(ตลัวเลขตตาแหนมง่ ของ Child element ใน Body) พารามธิเตอร์ร image กค็ก ือส Blob ของภาพ insertImage() คืสนคา่ล กลัตบมาเป็นป คลาส InlineImage ตวตั อยา่ล ง function insertImage() { // ภาพจากเวบ็ก var image = \"https://img.labnol.org/logo.png\" ; var blob = UrlFetchApp.fetch(image).getBlob() ; // ภาพจาก Google Drive var image = \"https://drive.google.com/open?id=11inBoKWzWZr_ip2OvBAv3BWY7TbW9JDt\" ; // จบัล มาเฉพาะ ID ของภาพ โดยใช้ช match ตดัล มาตาม Regular Expression ที่รทร ะบคุ var fileID = image.match(/[\\w\\_\\-]{25,}/).toString() ; // [\\w\\_\\-] เฉพาะ ตวร เลขและตวร อกร ษร และ _ และ - // {25,} ตึล้ัขงแต่มตวัล ท่ีทร 25 เปนป็ ต้นช ไป (นบัล ตัลวที่ทร Match [\\w\\_\\-] ) var blob = DriveApp.getFileById(fileID).getBlob() ; var doc = DocumentApp.getActiveDocument() ; // จบลั ตาต แหนง่ม ของ Cursor var cursor = doc.getCursor() ; if (cursor) { // ถช้ามีร Cursor ในเอกสาร – ใสมภ่ าพ ณ Cursor cursor.insertInlineImage(blob).setWidth(300).setHeight(168.75) ; } else { // ถชา้ ไม่มมีร Cursor doc.getBody().insertImage(0, image).setWidth(300).setHeight(168.75) ; } } ผล 62 Google Apps Script เซอรวพ์ ิพส Doucument
Search
