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