Documentation – الروابط والتنقل

Python-Net: إضافة رابط تطبيق

Thu, 11 Jun 2026 00:00:00 +0000

يمكن أن يتضمن PDF عناصر تفاعلية مثل الروابط التي تطلق تطبيقات خارجية. استخدام محرر محتوى PDF، يمكنك تحديد منطقة مستطيلة على صفحة تفتح، عند النقر عليها، ملفًا محددًا قابلاً للتنفيذ.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد منطقة مستطيل للارتباط القابل للنقر.
حدد مسار التطبيق لبدء التشغيل.
قم بتعيين لون الارتباط.
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_application_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add application launch link
    content_editor.create_application_link(
        apd.Rectangle(180, 530, 260, 20),
        "notepad.exe",
        1,
        apd.Color.purple,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة رابط إجراء مخصص

Thu, 11 Jun 2026 00:00:00 +0000

تسمح لك روابط الإجراءات المخصصة بتحديد مناطق تفاعلية في PDF يمكنها تشغيل إجراءات محددة عند النقر عليها، مثل تنفيذ البرامج النصية أو التنقل بين الصفحات أو تشغيل الأوامر الخاصة بالتطبيق. استخدام محرر محتوى PDF، يمكنك إنشاء رابط إجراء مخصص من خلال تحديد الصفحة والمستطيل واللون والإجراءات.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد مستطيلًا للارتباط القابل للنقر.
حدد رقم الصفحة ولون الرابط.
قم بتعيين إجراءات مخصصة (فارغة في هذا المثال).
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_custom_action_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add custom action link. Empty action list keeps the sample runnable
    # without requiring additional enum lookups.
    content_editor.create_custom_action_link(
        apd.Rectangle(200, 500, 260, 20),
        1,
        apd.Color.dark_red,
        [],
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة رابط جافا سكريبت

Thu, 11 Jun 2026 00:00:00 +0000

تسمح روابط JavaScript في ملفات PDF بوظائف تفاعلية مثل عرض التنبيهات أو إجراء العمليات الحسابية أو تعديل محتوى المستند ديناميكيًا. استخدام محرر محتوى PDF، يمكنك تحديد مستطيل قابل للنقر على الصفحة وربطه بشفرة JavaScript المخصصة.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد مستطيلًا لرابط JavaScript القابل للنقر.
حدد رقم الصفحة ولون الرابط.
قم بتعيين كود JavaScript للتنفيذ عند النقر عليه.
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_javascript_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add JavaScript link action
    content_editor.create_java_script_link(
        "app.alert('PdfContentEditor JavaScript link');",
        apd.Rectangle(160, 560, 260, 20),
        1,
        apd.Color.orange,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة رابط محلي

Thu, 11 Jun 2026 00:00:00 +0000

تسمح الارتباطات المحلية في ملفات PDF بالتنقل السريع بين الصفحات داخل نفس المستند. استخدام محرر محتوى PDF، يمكنك تحديد مستطيل قابل للنقر يربط صفحة بأخرى، مما يحسن قابلية استخدام المستند والتنقل فيه.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد مستطيلًا للارتباط المحلي القابل للنقر.
حدد صفحة المصدر وصفحة الوجهة.
قم بتعيين لون الارتباط.
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_local_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add a local link on page 1 to destination page 1
    content_editor.create_local_link(
        apd.Rectangle(120, 620, 220, 20),
        1,
        1,
        apd.Color.red,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة رابط مستند PDF

Thu, 11 Jun 2026 00:00:00 +0000

تسمح روابط مستندات PDF للمستخدمين بالانتقال من ملف PDF إلى آخر بسلاسة. استخدام محرر محتوى PDF، يمكنك تحديد مستطيل قابل للنقر يرتبط بصفحة في ملف PDF مختلف، مما يجعل مستنداتك تفاعلية ومتصلة.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد مستطيلًا للارتباط القابل للنقر.
حدد ملف PDF المرتبط وصفحة المصدر وصفحة الوجهة.
قم بتعيين لون الارتباط.
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_pdf_document_link(infile, linked_pdf, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add link to another PDF document
    content_editor.create_pdf_document_link(
        apd.Rectangle(140, 590, 240, 20),
        linked_pdf,
        1,
        1,
        apd.Color.green,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة رابط ويب

Thu, 11 Jun 2026 00:00:00 +0000

تسمح روابط الويب في ملفات PDF للمستخدمين بالانتقال مباشرة إلى الموارد أو مواقع الويب أو الوثائق عبر الإنترنت. استخدام محرر محتوى PDF، يمكنك تحديد منطقة مستطيلة على صفحة PDF تفتح، عند النقر عليها، عنوان URL في متصفح الويب الافتراضي.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
حدد مستطيلًا لرابط الويب القابل للنقر.
حدد عنوان URL ورقم الصفحة ولون الارتباط.
احفظ مستند PDF المحدث.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_web_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add a web link annotation to page 1
    content_editor.create_web_link(
        apd.Rectangle(100, 650, 200, 20),
        "https://products.aspose.com/pdf/python-net/",
        1,
        apd.Color.blue,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: استخراج الروابط

Thu, 11 Jun 2026 00:00:00 +0000

غالبًا ما يحتوي PDF على عناصر تفاعلية مثل روابط الويب وروابط المستندات والإجراءات المخصصة. استخدام محرر محتوى PDF، يمكنك استخراج جميع التعليقات التوضيحية للروابط من ملف PDF برمجيًا. يتيح لك ذلك فحص الروابط أو معالجتها، على سبيل المثال، للتحقق من عناوين URL أو تحليل أنماط التنقل في المستند.

قم بإنشاء مثيل محرر محتوى PDF.
قم بربط وثيقة PDF المدخلة.
استخرج جميع الروابط باستخدام ’extract_link () ‘.
قم بالتكرار من خلال الروابط المستخرجة.
تحقق مما إذا كان الرابط هو LinkAnNotation وما إذا كان الإجراء الخاص به هو GoTouriAction.
اطبع إحداثيات المستطيل وURI.
اعرض رسالة إذا لم يتم العثور على روابط.

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

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

from config import set_license, initialize_data_dir


def extract_links(infile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Extract links from the document
    links = content_editor.extract_link()

    count = 0
    for link in links:
        count += 1
        print(f"Link {count}: {link.rect}")
        if is_assignable(link, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, link)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                print(f"  URI: {action.uri}")

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