Documentation – Trabajando con PDF Facades

Python-Net: Clase PdfFileEditor

Mon, 05 Jan 2026 00:00:00 +0000

Trabajar con documentos PDF incluye varias funciones. Gestionar las páginas de un archivo PDF es una parte importante de este trabajo. ‘aspose.pdf.facades’ proporciona el PdfFileEditor clase para este propósito.

La clase PdfFileEditor contiene los métodos que ayudan a manipular páginas individuales; esta clase no edita ni manipula el contenido de una página. Puede insertar una nueva página, eliminar una página existente, dividir las páginas o especificar la imposición de las páginas usando PdfFileEditor.

Qué puedes hacer con PdfFileEditor

Las características proporcionadas por esta clase pueden agruparse en flujos de trabajo de edición de páginas, imposición de PDF y división de documentos. Estos artículos muestran cómo reorganizar páginas, combinar varios PDF, preparar archivos para impresión y extraer secciones de documentos existentes sin editar manualmente el archivo fuente.

Tutoriales de PdfFileEditor

Python-Net: Clase PdfContentEditor

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

El PdfContentEditor La clase en Aspose.PDF Facades está diseñada para tareas de edición a nivel de contenido en documentos PDF existentes. Proporciona una API simplificada para actualizar elementos interactivos, reemplazar texto, trabajar con adjuntos y enlaces, y ajustar el comportamiento del documento en aplicaciones Python vía .NET.

Qué puede hacer con PdfContentEditor

Utilice esta sección para explorar las principales áreas de edición de contenido PDF compatibles con el PdfContentEditor fachada:

Python-Net: Clase PdfAnnotationEditor

Thu, 05 Feb 2026 00:00:00 +0000

El PdfAnnotationEditor La clase en Aspose.PDF Facades está destinada a trabajar con anotaciones PDF y marcado basado en comentarios sin editar manualmente la estructura de bajo nivel de un documento. Proporciona una forma simplificada de manejar flujos de trabajo de anotaciones en Python via .NET cuando necesitas inspeccionar o actualizar archivos PDF existentes.

Para qué se usa PdfAnnotationEditor

Utilice esta fachada cuando su flujo de trabajo PDF incluya anotaciones, comentarios de revisión u otros elementos de marcado que necesiten ser gestionados programáticamente. A medida que esta sección se expanda, debería servir como página de inicio para tutoriales relacionados con anotaciones construidos alrededor del PdfAnnotationEditor clase.

Python-Net: Clase PdfFileSignature

Mon, 05 Jan 2026 00:00:00 +0000

Preparar auxiliares de firma digital PDF

Antes de aplicar una firma digital a un PDF, es una buena practica configurar un conjunto de funciones auxiliares reutilizables. Estas funciones encapsulan tareas comunes, como inicializar el controlador de firmas, definir la ubicacion visual de la firma y configurar la firma basada en certificados, para que la logica principal de firma se mantenga limpia, coherente y facil de mantener.

Que consigue esta configuracion

Esta capa auxiliar prepara todo lo necesario para un flujo de trabajo de firma fluido:

Inicializa un objeto PdfFileSignature y lo enlaza a un documento
Define donde aparecera la firma en la pagina
Carga y aplica un certificado de firma
Crea un objeto de firma PKCS#7 reutilizable con metadatos
Personaliza el aspecto visual de la firma

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

Python-Net: Clase FormEditor

Thu, 05 Mar 2026 00:00:00 +0000

El FormEditor La clase en Aspose.PDF Facades está diseñada para crear y actualizar campos de formulario PDF interactivos. Le ayuda a construir estructuras de formulario, ajustar las propiedades de los campos, cambiar la configuración de apariencia y adjuntar comportamiento interactivo, como scripts y acciones de envío, en aplicaciones Python.

Tareas comunes de FormEditor

Utilice los siguientes tutoriales para trabajar con las principales capacidades de FormEditor fachada:

Python-Net: Clase PdfFileInfo

Thu, 19 Mar 2026 00:00:00 +0000

El PdfFileInfo La clase en Aspose.PDF Facades proporciona acceso a información de PDF a nivel de documento y de página sin requerir un análisis de bajo nivel. Es útil cuando necesitas inspeccionar los metadatos, recuperar las propiedades del documento, comprobar los privilegios o examinar las dimensiones y desplazamientos de la página en flujos de trabajo automatizados.

Qué puede hacer con PdfFileInfo

Utilice los artículos en esta sección para explorar las principales capacidades de inspección de archivos del PdfFileInfo fachada:

Python-Net: Clase PdfFileSecurity

Wed, 18 Mar 2026 00:00:00 +0000

El PdfFileSecurity La clase en Aspose.PDF Facades se usa para proteger documentos PDF y controlar cómo los usuarios pueden interactuar con ellos. Soporta flujos de trabajo de seguridad comunes, como cifrado basado en contraseña, descifrado, rotación de contraseñas y gestión de permisos para imprimir, copiar y editar.

Qué puedes hacer con PdfFileSecurity

Utilice los artículos en esta sección para explorar las principales tareas de seguridad de PDF compatibles con el PdfFileSecurity fachada:

Python-Net: Clase PdfViewer

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

Aspose.PDF for Python via .NET proporciona el PdfViewer fachada para trabajar con la visualización de PDF y escenarios de decodificación de páginas. Un caso de uso común es convertir páginas PDF en objetos de imagen que luego pueden guardarse en el disco.

Crea un asistente PdfViewer reutilizable

Antes de decodificar páginas o leer propiedades relacionadas con el visor, cree un pequeño asistente que inicialice y devuelva un PdfViewer instancia. Esto mantiene los ejemplos a continuación autocontenidos y deja claro cómo se crea el objeto viewer antes de que se vincule a un documento PDF.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades


def _create_viewer() -> pdf_facades.PdfViewer:
    """Create a PdfViewer configured for decoding examples."""
    viewer = pdf_facades.PdfViewer()
    viewer.coordinate_type = ap.PageCoordinateType.MEDIA_BOX
    viewer.resolution = 150
    viewer.scale_factor = 1.0
    viewer.show_hidden_areas = False
    return viewer

Decodificar todas las páginas PDF

Usar decode_all_pages() cuando deseas convertir cada página del PDF en una imagen separada. Las imágenes de página devueltas pueden guardarse una por una en un directorio de salida.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_all_pages(infile: str, output_dir: str) -> None:
    """Decode all pages of a PDF document into image files."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        decoded_pages = viewer.decode_all_pages()

        for index, page_image in enumerate(decoded_pages, start=1):
            image_path = path.join(output_dir, f"decode_all_pages_{index}.png")
            page_image.save(image_path)
    finally:
        viewer.close_pdf_file()

Decodificar una página PDF específica

Usar decode_page() cuando solo necesitas una página del documento. Esto es útil al generar vistas previas, miniaturas o exportaciones específicas de página.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_specific_page(infile: str, outfile: str, page_number: int = 1) -> None:
    """Decode a specific PDF page into an image file."""
    viewer = _create_viewer()
    try:
        viewer.bind_pdf(infile)
        page_image = viewer.decode_page(page_number)
        page_image.save(outfile)

    finally:
        viewer.close()

Inspeccionar metadatos PDF

El inspect_pdf_metadata La función demuestra cómo abrir un documento PDF y recuperar metadatos básicos relacionados con el visor usando Aspose.PDF. Se centra en extraer información que describe cómo se interpreta y muestra el documento, en lugar de su contenido.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def inspect_pdf_metadata(infile: str) -> None:
    """Open a PDF and print page-count related viewer metadata."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        print(f"Page count: {viewer.page_count}")
        print(f"Coordinate type: {viewer.coordinate_type}")
        print(f"Resolution: {viewer.resolution}")
    finally:
        viewer.close_pdf_file()

Python-Net: Clase Form

Wed, 05 Nov 2025 00:00:00 +0000

Python-Net: Clase Stamp

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET proporciona el Sello clase para colocar contenido visual reutilizable en páginas PDF. Un sello puede basarse en texto, una imagen o incluso una página de otro PDF, y puede posicionarse, rotarse, estilizarse y limitarse a páginas específicas.

Este artículo muestra varios flujos de trabajo comunes de sellos:

Crea recursos de texto reutilizables para sellos basados en texto.
Agregar sellos de imagen y de página PDF.
Agregar sellos de texto con estilo.
Limitar un sello a páginas seleccionadas.
Configure un sello de imagen de fondo.

El ejemplo usa dos funciones auxiliares: una crea texto formateado para sellos basados en texto, y la otra crea un TextState objeto utilizado para dar estilo a los sellos de texto.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def _create_text_logo(text: str) -> pdf_facades.FormattedText:
    """Create formatted text for text stamp examples."""
    return pdf_facades.FormattedText(
        text,
        drawing.Color.blue,
        drawing.Color.light_gray,
        pdf_facades.FontStyle.HELVETICA_BOLD,
        pdf_facades.EncodingType.WINANSI,
        True,
        14,
    )


def _create_text_state() -> ap.text.TextState:
    """Create a text state used to style text stamps."""
    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.dark_blue
    text_state.font_size = 16
    text_state.font_style = ap.text.FontStyles.BOLD
    return text_state

Agregar una marca de imagen

Usar bind_image() cuando el sello debe mostrar una imagen como un logo, insignia o ícono. Después de enlazar la imagen, puedes establecer el ID del sello y el origen antes de añadirlo al documento.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp to the PDF."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.stamp_id = 1
        stamp.set_origin(36, 520)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Agregar una página PDF como sello

Usar bind_pdf() cuando deseas usar una página de otro archivo PDF como contenido del sello. Esto es útil para superposiciones, como aprobaciones, plantillas o elementos visuales preconstruidos almacenados en un documento separado.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_pdf_page_as_stamp(infile: str, stamp_pdf: str, outfile: str) -> None:
    """Add the first page of another PDF as a stamp."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_pdf(stamp_pdf, 1)
        stamp.page_number = 1
        stamp.set_origin(36, 250)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Agregar una marca de texto con estado de texto

Usar bind_logo() junto con bind_text_state() cuando deseas crear un sello basado en texto con estilo de fuente personalizado. Este enfoque es útil para marcas de aprobación, etiquetas y anotaciones específicas del flujo de trabajo.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_text_stamp_with_text_state(infile: str, outfile: str) -> None:
    """Add a text stamp and style it with a TextState object."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_logo(_create_text_logo("Approved by signing workflow"))
        stamp.bind_text_state(_create_text_state())
        stamp.set_origin(36, 700)
        stamp.rotation = 15.0

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Agregar un sello a páginas específicas

Si el sello no debe aparecer en cada página, asigne los números de página de destino a la pages propiedad. Este ejemplo agrega un ImageStamp solo a la primera página.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_stamp_to_specific_pages(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp only to the selected pages."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.pages = [1]
        stamp.set_origin(400, 40)
        stamp.set_image_size(120, 60)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Agregar una marca de imagen de fondo

Utiliza un sello de fondo cuando la imagen debe aparecer detrás del contenido de la página. También puedes controlar la opacidad, rotación, calidad, tamaño y posición del sello para crear efectos estilo marca de agua.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_background_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add a rotated background image stamp with opacity and quality settings."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.is_background = True
        stamp.opacity = 0.35
        stamp.quality = 90
        stamp.rotation = 45.0
        stamp.set_image_size(160, 80)
        stamp.set_origin(200, 300)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Temas relacionados con Facades

Python-Net: Clase PdfFileStamp

Tue, 14 Apr 2026 00:00:00 +0000

La clase PdfFileStamp en Aspose.PDF Facades esta disenada para agregar contenido visual repetido a paginas PDF. Es util cuando necesita aplicar encabezados, pies de pagina, numeros de pagina o sellos en un documento sin editar manualmente cada pagina.

Que puede hacer con PdfFileStamp

Use los articulos de esta seccion para explorar las tareas principales de sellado admitidas por la fachada PdfFileStamp: