Documentation – التعليقات التوضيحية

Python-Net: إضافة تعليق توضيحي على عربة التسوق

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

تُستخدم التعليقات التوضيحية لـ Caret بشكل شائع للإشارة إلى إدراج النص أو التعليقات التحريرية في المستند. باستخدام PDFContentEditor، يمكنك إضافة التعليقات التوضيحية برمجيًا عن طريق تحديد رقم الصفحة وحدود التعليقات التوضيحية ومنطقة الشرح والرمز ونص الملاحظة واللون.

قم بإنشاء محرر محتوى PDF كائن.
قم بربط ملف PDF المدخل.
تعريف معاملات التعليق التوضيحي لـ Caret:

رقم الصفحة حيث سيتم إضافة التعليق التوضيحي
مستطيل Caret (موضع التعليق التوضيحي)
مستطيل الشرح (منطقة النص)
الرمز (على سبيل المثال «P»)
نص التعليق التوضيحي
لون التعليق التوضيحي

أضف التعليق التوضيحي لـ Caret.
احفظ المستند المحدث.

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

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

from config import set_license, initialize_data_dir


def add_caret_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add caret annotation to page 1
    content_editor.create_caret(
        1,
        apd.Rectangle(350, 400, 10, 10),
        apd.Rectangle(300, 380, 115, 15),
        "P",
        "This is a caret annotation",
        apd.Color.red,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة تعليقات توضيحية نصية مجانية

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

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

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

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

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

from config import set_license, initialize_data_dir


def add_free_text_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add free text annotation to page 1
    content_editor.create_free_text(
        apd.Rectangle(200, 480, 150, 25), "This is a free text annotation", 1
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة تعليقات توضيحية للترميز

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

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

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

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

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

from config import set_license, initialize_data_dir


def add_markup_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add markup annotation to page 1
    content_editor.create_markup(
        apd.Rectangle(120, 440, 200, 20),
        "This is a highlight annotation",
        0,
        1,
        apd.Color.yellow,
    )
    content_editor.create_markup(
        apd.Rectangle(110, 542, 200, 20),
        "This is a underline annotation",
        1,
        1,
        apd.Color.yellow,
    )
    content_editor.create_markup(
        apd.Rectangle(120, 568, 200, 20),
        "This is a strikeout annotation",
        2,
        1,
        apd.Color.orange_red,
    )
    content_editor.create_markup(
        apd.Rectangle(110, 598, 200, 20),
        "This is a squiggly annotation",
        3,
        1,
        apd.Color.dark_blue,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة تعليقات توضيحية منبثقة

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

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

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

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

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

from config import set_license, initialize_data_dir


def add_popup_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add popup annotation to page 1
    content_editor.create_popup(
        apd.Rectangle(220, 520, 180, 80),
        "This is a popup annotation",
        True,
        1,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: إضافة تعليقات توضيحية نصية

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

توضح هذه المقالة كيفية إضافة تعليق توضيحي نصي إلى مستند PDF باستخدام محرر محتوى PDF الفصل الدراسي في Aspose.PDF.

تتيح لك التعليقات التوضيحية النصية إرفاق تعليقات أو ملاحظات أو معلومات إضافية بأجزاء معينة من صفحة PDF. يمكن أن تظهر هذه التعليقات التوضيحية كرموز ويتم توسيعها من قبل المستخدمين عند عرض المستند.

في هذا المثال:

يتم تحميل وثيقة PDF في محرر محتوى PDF.
تتم إضافة تعليق توضيحي نصي في موضع محدد على الصفحة.
يتضمن التعليق التوضيحي العنوان والمحتوى ونوع الرمز وإعدادات الرؤية.
يتم حفظ المستند المعدل إلى ملف جديد.

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

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

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

from config import set_license, initialize_data_dir


def add_text_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add text annotation to page 1
    content_editor.create_text(
        apd.Rectangle(100, 400, 50, 50),
        "Text Annotation",
        "This is a text annotation",
        True,
        "Insert",
        1,
    )
    # Save updated document
    content_editor.save(outfile)