Documentation – Gestión de sellos

Python-Net: Agregar sello de goma

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de sello de goma se usan comúnmente en PDFs para indicar aprobación, estado de revisión u otras notas. Usando PdfContentEditor, puede definir un rectángulo para el sello, establecer su texto y comentarios, elegir un color y aplicarlo a varias páginas de un documento.

Crea una instancia de PdfContentEditor.
Vincula el documento PDF de entrada.
Recorrer las páginas 1–34.
Agregar una anotación de sello de goma con texto personalizado, comentarios y color.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_rubber_stamp(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    for i in range(1, 5):
        content_editor.create_rubber_stamp(
            i,
            apd.Rectangle(120, 450, 180, 60),
            "Approved",
            "Approved by reviewer",
            apd.Color.green,
        )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Crear sello de goma con archivo de apariencia

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de sello de goma pueden personalizarse no solo con texto sino también usando un archivo de imagen como su apariencia. Este enfoque es útil para agregar logotipos de la empresa, sellos de firma o cualquier indicación visual a sus páginas PDF.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Defina un rectángulo para el sello.
Utilice un archivo de imagen personalizado para definir la apariencia del sello de caucho.
Establezca el texto y el color del sello.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Crear Sello de Goma con Flujo de Apariencia

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de sello de goma pueden personalizarse usando un archivo de imagen externo. En lugar de depender solo de sellos basados en texto, puede definir una apariencia visual (por ejemplo, el logotipo de la empresa o una insignia de aprobación) y colocarla en una página.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Defina un rectángulo para la ubicación del sello.
Utilice un archivo de imagen como apariencia del sello.
Aplique configuraciones de texto y color.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Mover sello por índice

Fri, 20 Mar 2026 00:00:00 +0000

Cuando existen varios sellos de caucho en una página, puedes mover uno específico usando su índice. El método move_stamp() permite reposicionar anotaciones según su secuencia, lo cual es útil cuando no rastreas los IDs de los sellos pero conoces su orden.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Agregar dos anotaciones de sello de caucho en la misma página.
Demostrar cómo mover un sello usando su índice.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )
    content_editor.save(outfile)

    # Move first stamp on page 1 by index
    # content_editor.move_stamp(1, 1, 10, 10)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Eliminar sellos globalmente

Fri, 20 Mar 2026 00:00:00 +0000

Al trabajar con múltiples páginas, es posible que necesite eliminar ciertos sellos en todo el documento. Los métodos \u0027delete_stamp_by_id()\u0027 y \u0027delete_stamp_by_ids()\u0027 le permiten eliminar sellos globalmente por sus identificadores, eliminando la necesidad de iterar manualmente a través de cada página.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Agregar sellos de goma a múltiples páginas.
Eliminar sellos globalmente usando sus IDs.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def delete_stamps_globally(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Add stamps across multiple pages so global deletion is meaningful
    for page in range(1, 5):
        content_editor.create_rubber_stamp(
            page,
            apd.Rectangle(120, 500, 180, 60),
            "Draft",
            "Stamp for global deletion",
            apd.Color.gray,
        )

    # delete_stamp_by_id without page number removes stamp ID from all pages
    content_editor.delete_stamp_by_id(1)
    # delete_stamp_by_ids without page number removes a list of IDs from all pages
    content_editor.delete_stamp_by_ids([2, 3])

    # Save updated document
    content_editor.save(outfile)

Python-Net: Listar Sellos

Fri, 20 Mar 2026 00:00:00 +0000

Cuando se trabaja con PDFs anotados, puede ser necesario inspeccionar los sellos de goma existentes antes de modificarlos o eliminarlos. El método ‘get_stamps()’ permite recuperar todos los sellos colocados en una página determinada. Luego puede iterar a través de los resultados y procesarlos programáticamente.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Recuperar todos los sellos de la página 1.
Iterar a través de la colección de sellos.
Imprimir cada sello.
Mostrar un mensaje si no existen sellos.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def list_stamps(infile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # List all stamps on page 1
    stamps = content_editor.get_stamps(1)

    count = 0
    for stamp in stamps:
        count += 1
        print(f"Stamp {count}: {stamp}")

    if count == 0:
        print("No stamps found")

Python-Net: Mover sello por ID

Fri, 20 Mar 2026 00:00:00 +0000

Después de agregar una anotación de sello de goma a un PDF, es posible que necesite ajustar su posición. El método ‘move_stamp_by_id()’ le permite reubicar un sello basado en su identificador, sin recrearlo. Esto es útil en flujos de trabajo automatizados donde la colocación del sello debe ajustarse dinámicamente.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Agregar una anotación de sello de goma.
Mueve el sello usando su ID.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_id_example(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(300, 420, 180, 60),
        "Approved",
        "Move this stamp by ID",
        apd.Color.green,
    )

    # Move stamp by ID overload
    content_editor.move_stamp_by_id(1, 1, 240, 360)

    # Save updated document
    content_editor.save(outfile)

Python-Net: Eliminar sello por ID

Fri, 20 Mar 2026 00:00:00 +0000

Al trabajar con PDFs que contienen múltiples sellos, a menudo es necesario eliminar sellos específicos sin afectar a los demás. Usando la eliminación basada en ID, puedes controlar con precisión qué sellos eliminar:

‘delete_stamp_by_id(stamp_id, page_number)’ – elimina un solo sello por su ID en una página específica
‘delete_stamp_by_ids(page_number, stamp_ids)’ – elimina varios sellos por sus IDs en una página dada

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Añade dos sellos de goma con IDs distintos.
Elimina sellos utilizando tanto el método de eliminación por ID único como el de eliminación por varios IDs.
Guardar el PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def delete_stamp_by_ids_examples(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Create two stamps on page 1 so they can be deleted by ID
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 320, 180, 60),
        "Draft",
        "Delete by single ID",
        apd.Color.orange,
    )
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 250, 180, 60),
        "Draft",
        "Delete by multiple IDs",
        apd.Color.orange,
    )

    # Delete by single ID overload and by IDs overload
    content_editor.delete_stamp_by_id(1, 1)
    content_editor.delete_stamp_by_ids(1, [2])

    # Save updated document
    content_editor.save(outfile)

Python-Net: Mover Sello Por Índice

Fri, 20 Mar 2026 00:00:00 +0000

En la edición de PDF, puede ser necesario ajustar la posición de los sellos de goma existentes. Este fragmento de código muestra cómo:

Agregar varios sellos en la misma página
Prepararlos para reposicionarlos usando su índice
Opcionalmente mover un sello especificando su página, índice y nuevas coordenadas

El método ‘move_stamp(page_number, stamp_index, new_x, new_y)’ puede reposicionar los sellos de manera precisa.

Crear un PdfContentEditor objeto.
Vincula el PDF al editor.
Añade varios sellos de goma a una página.
Guarda el documento antes de realizar operaciones de movimiento.
Mover un sello específico por su índice.
Guarde el PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )
    content_editor.save(outfile)

    # Move first stamp on page 1 by index
    # content_editor.move_stamp(1, 1, 10, 10)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Administrar Sello por ID

Fri, 20 Mar 2026 00:00:00 +0000

En PDFs con múltiples sellos de goma, puede ser útil controlar sellos individuales basándose en su ID. Los métodos ‘hide_stamp_by_id()’ y ‘show_stamp_by_id()’ permiten un control selectivo de la visibilidad. Este ejemplo muestra cómo:

Agregar múltiples sellos con IDs únicos
Ocultar un sello en una página específica
Mostrar un sello en otra página

Al usar operaciones basadas en ID, evitas rastrear sellos por posición de página u otros atributos.

Crear un PdfContentEditor instancia.
Vincula el documento PDF de entrada.
Agregar sellos de goma con IDs específicos.
Ocultar y mostrar sellos según sus IDs y números de página.
Guarda el documento PDF actualizado.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def manage_stamp_by_id(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    # Apply ID-based stamp operations
    content_editor.hide_stamp_by_id(1, 1)
    content_editor.show_stamp_by_id(1, 2)

    # Save updated document
    content_editor.save(outfile)