استخدام القوائم

تتيح واجهة برمجة تطبيقات محرر مستندات Google تحويل الفقرات العادية إلى قوائم نقطية إزالة الرموز النقطية من الفقرات.

تحويل فقرة إلى قائمة

هناك عملية تنسيق شائعة للفقرات تتمثل في تحويل الفقرات إلى رموز نقطية الحالية.

لإنشاء قائمة، استخدم 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()
تحويل فقرة إلى قائمة
الشكل 1. تحويل فقرة إلى قائمة

إزالة الرموز النقطية من قائمة

لإزالة الرموز النقطية من قائمة الفقرات، استخدم 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()