تتيح واجهة Google Docs API تحويل الفقرات العادية إلى قوائم نقطية وإزالة النقاط من الفقرات.
تحويل فقرة إلى قائمة
من العمليات الشائعة لتنسيق الفقرات تحويلها إلى قائمة نقطية.
لإنشاء قائمة، استخدِم الطريقة
documents.batchUpdate
وقدِّم
CreateParagraphBulletsRequest
.
أدرِج Range
لتحديد الخلايا المتأثرة وBulletGlyphPreset
لضبط نمط النقطة.
يتم وضع نقاط تعداد في جميع الفقرات التي تتداخل مع النطاق المحدّد. إذا كان النطاق المحدّد يتداخل مع جدول، يتم تطبيق الرموز النقطية داخل خلايا الجدول. يتم تحديد مستوى التداخل لكل فقرة من خلال احتساب علامات التبويب البادئة قبل كل فقرة.
لا يمكنك تعديل مستوى التداخل لنقطة تعداد حالية. بدلاً من ذلك، عليك حذف النقطة، وضبط علامات التبويب البادئة أمام الفقرة، ثم إنشاء النقطة مرة أخرى. لمزيد من المعلومات، يُرجى الاطّلاع على إزالة النقاط من قائمة.
يمكنك أيضًا استخدام CreateParagraphBulletsRequest
لتغيير نمط التعداد النقطي لقائمة حالية.
يعرض نموذج الرمز التالي طلبًا مجمّعًا يدرج النص أولاً في بداية المستند، ثم ينشئ قائمة من الفقرات التي تمتد على أول 50 حرفًا. يستخدم BulletGlyphPreset
BULLET_ARROW_DIAMOND_DISC
، ما يعني أنّ مستويات التداخل الثلاثة الأولى من
القائمة النقطية ممثّلة بسهم وماسة وقرص.
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()