Añadir y Eliminar un Marcador usando Python

Añadir un Marcador a un Documento PDF

Los marcadores se mantienen en la colección OutlineItemCollection del objeto Document, que a su vez está en la colección OutlineCollection.

Para añadir un marcador a un PDF:

1. Abra un documento PDF usando el objeto Document.
2. Cree un marcador y defina sus propiedades.
3. Añada la colección OutlineItemCollection a la colección de Outlines.

El siguiente fragmento de código muestra cómo añadir un marcador en un documento PDF.

    import aspose.pdf as ap

    # Abrir documento
    document = ap.Document(input_pdf)

    # Crear un objeto de marcador
    outline = ap.OutlineItemCollection(document.outlines)
    outline.title = "Marcador de Prueba"
    outline.italic = True
    outline.bold = True
    # Establecer el número de página de destino
    outline.action = ap.annotations.GoToAction(document.pages[1])
    # Añadir marcador en la colección de esquemas del documento.
    document.outlines.append(outline)

    # Guardar salida
    document.save(output_pdf)

Añadir un Marcador Hijo al Documento PDF

Los marcadores pueden estar anidados, indicando una relación jerárquica con marcadores padre e hijo. Este artículo explica cómo añadir un marcador hijo, es decir, un marcador de segundo nivel, a un PDF.

Para añadir un marcador hijo a un archivo PDF, primero añada un marcador padre:

1. Abra un documento.
2. Añada un marcador a la OutlineItemCollection, definiendo sus propiedades.
3. Añada la OutlineItemCollection a la colección OutlineCollection del objeto Document.

El marcador hijo se crea igual que el marcador padre, explicado arriba, pero se agrega a la colección de Contornos del marcador padre.

Los siguientes fragmentos de código muestran cómo añadir un marcador hijo a un documento PDF.

    import aspose.pdf as ap

    # Abrir documento
    document = ap.Document(input_pdf)

    # Crear un objeto de marcador padre
    outline = ap.OutlineItemCollection(document.outlines)
    outline.title = "Contorno Padre"
    outline.italic = True
    outline.bold = True

    # Crear un objeto de marcador hijo
    childOutline = ap.OutlineItemCollection(document.outlines)
    childOutline.title = "Contorno Hijo"
    childOutline.italic = True
    childOutline.bold = True

    # Añadir marcador hijo en la colección del marcador padre
    outline.append(childOutline)
    # Añadir marcador padre en la colección de contornos del documento.
    document.outlines.append(outline)

    # Guardar salida
    document.save(output_pdf)

Eliminar todos los Marcadores de un Documento PDF

Todos los marcadores en un PDF se mantienen en la colección OutlineCollection. Este artículo explica cómo eliminar todos los marcadores de un archivo PDF.

Para eliminar todos los marcadores de un archivo PDF:

1. Llame al método Delete de la colección OutlineCollection.
2. Guarde el archivo modificado usando el método save() del objeto Document.

Los siguientes fragmentos de código muestran cómo eliminar todos los marcadores de un documento PDF.

    import aspose.pdf as ap

    # Abrir documento
    document = ap.Document(input_pdf)

    # Eliminar todos los marcadores
    document.outlines.delete()

    # Guardar archivo actualizado
    document.save(output_pdf)

Eliminar un Marcador Particular de un Documento PDF

Para eliminar un marcador particular de un archivo PDF:

1. Pase el título del marcador como parámetro al método Delete de la colección OutlineCollection.
2. Luego guarde el archivo actualizado con el método Save del objeto Document.

La clase Document proporciona la colección OutlineCollection. El método delete() elimina cualquier marcador con el título pasado al método.

Los siguientes fragmentos de código muestran cómo eliminar un marcador particular del documento PDF.

    import aspose.pdf as ap

    # Abrir documento
    document = ap.Document(input_pdf)

    # Eliminar un esquema particular por título
    document.outlines.delete("Child Outline")

    # Guardar archivo actualizado
    document.save(output_pdf)