Documentation – Gerenciamento de Carimbos

Python-Net: Adicionar Carimbo de Borracha

Mon, 18 May 2026 00:00:00 +0000

Anotações de carimbo de borracha são comumente usadas em PDFs para indicar aprovação, status de revisão ou outras notas. Usando PdfContentEditor, você pode definir um retângulo para o carimbo, definir seu texto e comentários, escolher uma cor e aplicá-lo a várias páginas de um documento.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Percorra as páginas 1–34.
Adicione uma anotação de selo de borracha com texto personalizado, comentários e cor.
Salve o documento PDF atualizado.

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: Criar Carimbo de Borracha com Arquivo de Aparência

Mon, 18 May 2026 00:00:00 +0000

As anotações de carimbo de borracha podem ser personalizadas não apenas com texto, mas também usando um arquivo de imagem como sua aparência. Essa abordagem é útil para adicionar logotipos de empresa, carimbos de assinatura ou qualquer indicador visual às suas páginas PDF.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Defina um retângulo para o carimbo.
Use um arquivo de imagem personalizado para definir a aparência do carimbo de borracha.
Defina o texto e a cor do carimbo.
Salve o documento PDF atualizado.

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: Criar Carimbo de Borracha com Fluxo de Aparência

Mon, 18 May 2026 00:00:00 +0000

Anotações de carimbo de borracha podem ser personalizadas usando um arquivo de imagem externo. Em vez de depender apenas de carimbos baseados em texto, você pode definir uma aparência visual (por exemplo, um logotipo da empresa ou um selo de aprovação) e colocá-la em uma página.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Defina um retângulo para a localização do carimbo.
Use um arquivo de imagem como a aparência do carimbo.
Aplique configurações de texto e cor.
Salve o documento PDF atualizado.

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: Excluir Carimbo por Índice

Mon, 18 May 2026 00:00:00 +0000

Quando múltiplos carimbos de borracha existem em uma página, você pode excluir um específico usando seu índice. O método delete_stamp() permite remover anotações de acordo com sua sequência, o que é útil quando você não rastreia IDs de carimbos, mas conhece sua ordem.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Vincule o arquivo PDF de entrada à instância PdfContentEditor usando bind_pdf(infile).
Chame ‘delete_stamp(1, [2, 3])’ para remover o carimbo com índice 1 das páginas 2 e 3.
Salve o documento PDF modificado no arquivo de saída usando save(outfile).

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_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    content_editor.delete_stamp(1, [2, 3])
    # Save updated document
    content_editor.save(outfile)

Python-Net: Excluir Selos Globalmente

Mon, 18 May 2026 00:00:00 +0000

Ao trabalhar com múltiplas páginas, pode ser necessário remover certos selos em todo o documento. Os métodos ‘delete_stamp_by_id()’ e ‘delete_stamp_by_ids()’ permitem excluir selos globalmente pelos seus identificadores, eliminando a necessidade de iterar manualmente por cada página.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Adicionar selos de borracha a várias páginas.
Excluir selos globalmente usando seus IDs.
Salve o documento PDF atualizado.

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 Carimbos

Mon, 18 May 2026 00:00:00 +0000

Ao trabalhar com PDFs anotados, pode ser necessário inspecionar os carimbos de borracha existentes antes de modificá-los ou removê-los. O método ‘get_stamps()’ permite recuperar todos os carimbos colocados em uma página específica. Você pode então percorrer os resultados e processá-los programaticamente.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Recuperar todos os carimbos da página 1.
Itere pela coleção de carimbos.
Imprima cada carimbo.
Exiba uma mensagem se não houver carimbos.

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 Carimbo Por ID

Mon, 18 May 2026 00:00:00 +0000

Depois de adicionar uma anotação de carimbo de borracha a um PDF, pode ser necessário ajustar sua posição. O método ‘move_stamp_by_id()’ permite realocar um carimbo com base em seu identificador, sem recriá‑lo. Isso é útil em fluxos de trabalho automatizados onde a colocação do carimbo deve ser ajustada dinamicamente.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Adicionar uma anotação de carimbo de borracha.
Mova o carimbo usando seu ID.
Salve o documento PDF atualizado.

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: Excluir Carimbo por ID

Mon, 18 May 2026 00:00:00 +0000

Ao trabalhar com PDFs contendo múltiplos carimbos, muitas vezes é necessário remover carimbos específicos sem afetar os demais. Usando exclusão baseada em ID, você pode controlar precisamente quais carimbos remover:

'delete_stamp_by_id(stamp_id, page_number)' – exclui um único carimbo pelo seu ID em uma página específica
'delete_stamp_by_ids(page_number, stamp_ids)' – exclui múltiplos carimbos pelos seus IDs em uma página especificada

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Adicione dois carimbos de borracha com IDs distintos.
Exclua carimbos usando métodos de exclusão de ID único e ID múltiplo.
Salve o PDF atualizado.

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 Carimbo Por Índice

Mon, 18 May 2026 00:00:00 +0000

Na edição de PDF, pode ser necessário ajustar a posição de carimbos de borracha existentes. Este trecho de código mostra como:

Adicionar Vários Carimbos na Mesma Página
Prepare-os para reposicionamento usando seu índice
Opcionalmente, mova um selo especificando sua página, índice e novas coordenadas

O método ‘move_stamp(page_number, stamp_index, new_x, new_y)’ pode reposicionar selos com precisão.

Criar um PdfContentEditor objeto.
Vincule o PDF ao editor.
Adicione vários selos de borracha a uma página.
Salve o documento antes de executar operações de movimentação.
Mover um carimbo específico pelo seu índice.
Salve o PDF atualizado.

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: Gerenciar Carimbo por ID

Mon, 18 May 2026 00:00:00 +0000

Em PDFs com múltiplos carimbos de borracha, pode ser útil controlar carimbos individuais com base em seu ID. Os métodos ‘hide_stamp_by_id()’ e ‘show_stamp_by_id()’ permitem o controle seletivo de visibilidade. Este exemplo mostra como:

Adicionar múltiplos carimbos com IDs exclusivos
Ocultar um carimbo em uma página específica
Mostrar um carimbo em outra página

Ao usar operações baseadas em ID, você evita rastrear carimbos por posição de página ou outros atributos.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Adicionar carimbos de borracha com IDs específicos.
Ocultar e mostrar carimbos com base em seus IDs e números de página.
Salve o documento PDF atualizado.

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)