Mit Listen arbeiten

Die Google Docs API unterstützt die Konvertierung von einfachen Absätzen in Aufzählungslisten und Aufzählungszeichen aus Absätzen zu entfernen.

Absätze in Listen umwandeln

Eine gängige Absatzformatierung besteht darin, Absätze in eine Aufzählungsliste umzuwandeln. Liste.

Verwenden Sie zum Erstellen einer Liste die Methode documents.batchUpdate und geben eine CreateParagraphBulletsRequest Fügen Sie Range hinzu, um die betroffene Zellen und eine BulletGlyphPreset um das Muster für den Aufzählungspunkt festzulegen.

Alle Absätze, die sich mit dem angegebenen Bereich überschneiden, werden mit einer Aufzählung versehen. Wenn sich der angegebene Bereich mit einer Tabelle überschneidet, werden die Aufzählungspunkte in den Tabellenzellen angewendet. Die Die Verschachtelungsebene jedes Absatzes wird durch das Zählen der vorstehenden Tabulatoren bestimmt. jedes Absatzes.

Die Verschachtelungsebene einer vorhandenen Aufzählung kann nicht angepasst werden. Löschen Sie stattdessen den Aufzählungspunkt, stellen Sie die vorderen Tabs vor das und erstellen Sie den Aufzählungspunkt erneut. Weitere Informationen finden Sie unter Aufzählungspunkte aus einer Liste entfernen.

Sie können auch CreateParagraphBulletsRequest verwenden, um den Stil der Aufzählungszeichen für einer vorhandenen Liste.

Das folgende Codebeispiel zeigt eine Batchanfrage, des Dokuments und erstellt dann eine Liste aus den Absätzen, die sich über die ersten 50 Zeichen. Für BulletGlyphPreset wird BULLET_ARROW_DIAMOND_DISC verwendet. Das bedeutet, dass die ersten drei Verschachtelungsebenen der Aufzählungsliste durch einen Pfeil, einen Rauten- und einen Kreis dargestellt werden.

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()
Absätze in Listen umwandeln
Abbildung 1: Absätze in Listen umwandeln

Aufzählungszeichen aus einer Liste entfernen

Um Aufzählungszeichen aus einer Absatzliste zu entfernen, verwenden Sie die documents.batchUpdate und geben eine DeleteParagraphBulletsRequest Fügen Sie Range hinzu, um die betroffene Zellen.

Die Methode löscht alle Aufzählungszeichen, die sich mit dem angegebenen Bereich überschneiden, Verschachtelungsebene. Um die Verschachtelungsebene visuell beizubehalten, wird dem Objekt den Anfang jedes entsprechenden Absatzes.

Im folgenden Codebeispiel wird eine Batchanfrage gezeigt, mit der Aufzählungspunkte aus einer Absatzliste gelöscht werden.

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