Google เอกสาร API รองรับการแปลงย่อหน้าธรรมดาเป็นรายการสัญลักษณ์หัวข้อย่อยและ การนำสัญลักษณ์หัวข้อย่อยออกจากย่อหน้า
เปลี่ยนย่อหน้าเป็นรายการ
การดำเนินการจัดรูปแบบย่อหน้าที่พบบ่อยคือการแปลงย่อหน้าเป็นรายการหัวข้อย่อย
หากต้องการสร้างรายการ ให้ใช้วิธี
documents.batchUpdate
และระบุ
CreateParagraphBulletsRequest
ใส่ Range
เพื่อระบุ
เซลล์ที่ได้รับผลกระทบและ
BulletGlyphPreset
เพื่อกำหนดรูปแบบสำหรับหัวข้อย่อย
ย่อหน้าทั้งหมดที่ทับซ้อนกับช่วงที่ระบุจะมีสัญลักษณ์แสดงหัวข้อย่อย หากช่วงที่ระบุทับซ้อนกับตาราง ระบบจะใช้หัวข้อย่อยภายในเซลล์ของตาราง ระบบจะกำหนด ระดับการซ้อนของแต่ละย่อหน้าโดยการนับแท็บนำหน้า แต่ละย่อหน้า
คุณปรับระดับการซ้อนของหัวข้อย่อยที่มีอยู่ไม่ได้ แต่คุณต้องลบสัญลักษณ์หัวข้อย่อย ตั้งค่าแท็บนำหน้า ย่อหน้า แล้วสร้างสัญลักษณ์หัวข้อย่อยอีกครั้ง ดูข้อมูลเพิ่มเติมได้ที่นำหัวข้อย่อย ออกจากรายการ
นอกจากนี้ คุณยังใช้ CreateParagraphBulletsRequest
เพื่อเปลี่ยนรูปแบบหัวข้อย่อยสำหรับรายการที่มีอยู่ได้ด้วย
ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่แทรกข้อความที่
จุดเริ่มต้นของเอกสารก่อน จากนั้นจะสร้างรายการจากย่อหน้าที่ครอบคลุม
อักขระ 50 ตัวแรก BulletGlyphPreset
ใช้
BULLET_ARROW_DIAMOND_DISC
ซึ่งหมายความว่าระดับการซ้อน 3 ระดับแรกของ
รายการแบบมีหัวข้อย่อยจะแสดงด้วยลูกศร เพชร และวงกลม
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setInsertText(new InsertTextRequest() .setText("Item One\n") .setLocation(new Location().setIndex(1).setTabId(TAB_ID)))); requests.add(new Request().setCreateParagraphBullets( new CreateParagraphBulletsRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(50) .setTabId(TAB_ID)) .setBulletPreset("BULLET_ARROW_DIAMOND_DISC"))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [ { 'insertText': { 'location': { 'index': 1, 'tabId': TAB_ID }, 'text': 'Item One\n', }}, { 'createParagraphBullets': { 'range': { 'startIndex': 1, 'endIndex': 50, 'tabId': TAB_ID }, 'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC', } } ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()
นำสัญลักษณ์แสดงหัวข้อย่อยออกจากรายการ
หากต้องการนำหัวข้อย่อยออกจากรายการย่อหน้า ให้ใช้วิธี
documents.batchUpdate
และระบุ
DeleteParagraphBulletsRequest
ใส่ Range
เพื่อระบุเซลล์ที่ได้รับผลกระทบ
เมธอดนี้จะลบหัวข้อย่อยทั้งหมดที่ทับซ้อนกับช่วงที่ระบุ ไม่ว่าจะมีระดับการซ้อนเท่าใดก็ตาม ระบบจะเพิ่มการเยื้องที่จุดเริ่มต้นของแต่ละย่อหน้าเพื่อให้เห็นระดับการซ้อนกัน
ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่ลบหัวข้อย่อยออกจากรายการย่อหน้า
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setDeleteParagraphBullets( new DeleteParagraphBulletsRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(50) .setTabId(TAB_ID)))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [ { 'deleteParagraphBullets': { 'range': { 'startIndex': 1, 'endIndex': 50, 'tabId': TAB_ID }, } } ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()