Utilizza gli elenchi

L'API Google Documenti supporta la conversione di paragrafi semplici in elenchi puntati e rimuovendo gli elenchi puntati dai paragrafi.

Convertire un paragrafo in un elenco

Un'operazione comune di formattazione dei paragrafi consiste nel convertire i paragrafi in un elenco puntato dall'elenco di lettura.

Per creare un elenco, utilizza documents.batchUpdate e fornisce un CreateParagraphBulletsRequest. Includi un elemento Range per specificare le celle interessate e un BulletGlyphPreset per impostare il pattern per il punto elenco.

Tutti i paragrafi che si sovrappongono all'intervallo specificato sono puntati. Se viene specificato si sovrappone a un intervallo con una tabella, i punti elenco vengono applicati all'interno delle celle della tabella. La il livello di nidificazione di ogni paragrafo è determinato contando le tabulazioni iniziali in avanti di ogni paragrafo.

Non puoi regolare il livello di annidamento di un punto elenco esistente. Devi invece eliminare il punto elenco, impostare le schede iniziali prima del e poi creare di nuovo il punto elenco. Per ulteriori informazioni, consulta la sezione Rimuovere un elenco puntato da un elenco.

Puoi anche utilizzare CreateParagraphBulletsRequest per modificare lo stile dei punti elenco di un elenco esistente.

Il seguente esempio di codice mostra una richiesta batch che inserisce prima il testo del documento, che crea un elenco di paragrafi i primi 50 caratteri. BulletGlyphPreset utilizza BULLET_ARROW_DIAMOND_DISC, che indica i primi tre livelli di nidificazione del l'elenco puntato è rappresentato da una freccia, un rombo e un disco.

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()
Convertire un paragrafo in un elenco.
Figura 1. Converti un paragrafo in un elenco.

Rimuovere punti elenco da un elenco

Per rimuovere i punti elenco da un elenco di paragrafi, utilizza la documents.batchUpdate e fornisce un DeleteParagraphBulletsRequest. Includi un elemento Range per specificare le celle interessate.

Il metodo elimina tutti i punti elenco che si sovrappongono all'intervallo specificato, indipendentemente di annidamento. Per preservare visivamente il livello di annidamento, viene aggiunto il rientro l'inizio di ogni paragrafo corrispondente.

L'esempio di codice seguente mostra una richiesta batch che elimina punti elenco da un elenco di paragrafi.

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