Aspose.PDF FOSS
Java
راهنمای توسعه دهنده
عناصر صفحه

عناصر صفحه

این راهنما نشان می‌دهد که چگونه با هندسه صفحه، تزئینات artifact، و پیوست‌های فایل توکار در Aspose.PDF FOSS برای Java کار کنید. شما یاد خواهید گرفت ابعاد صفحه را از طریق getMediaBox() بخوانید، اشیای Artifact را فهرست کنید، و EmbeddedFileCollection را مدیریت کنید.

هندسه صفحه

هر Page هندسه خود را از طریق ویژگی‌های جعبه افشا می‌کند:

  • getMediaBox() — مرز کامل صفحه
  • getCropBox() — ناحیه قابل مشاهده
  • getRotate() — چرخش صفحه بر حسب درجه (0، 90، 180 یا 270)

عرض و ارتفاع را از جعبه رسانه بخوانید تا موقعیت‌ها برای قرار دادن محتوا محاسبه شوند:

try (Document doc = new Document("input.pdf")) {
    PageCollection pages = doc.getPages();
    Page page = pages.get(1);
    double width  = page.getMediaBox().getWidth();
    double height = page.getMediaBox().getHeight();
    System.out.println("Page size: " + width + " x " + height + " pt");
}

استاندارد A4 برابر 595 × 842 نقطه است؛ US Letter برابر 612 × 792 نقطه است.

Artifacts

کلاس Artifact مدل‌سازی تزئینات صفحه را انجام می‌دهد: سرصفحه‌ها، پاصفحه‌ها، واترمارک‌ها و تصاویر پس‌زمینه. آرتیفکت‌ها عناصری غیرمحتوا هستند که در مشخصات PDF تعریف شده‌اند.

مجموعه آرتیفکت‌های یک صفحه را تکرار کنید تا نوع و زیرنوع هر تزئین را بررسی کنید:

try (Document doc = new Document("input.pdf")) {
    PageCollection pages = doc.getPages();
    Page page = pages.get(1);
    for (Artifact artifact : page.getArtifacts()) {
        System.out.println(artifact.getArtifactType() + " / " + artifact.getSubtype());
    }
}

فایل‌های جاسازی‌شده

EmbeddedFileCollection، که از طریق Document.getEmbeddedFiles() قابل دسترسی است، پیوست‌های فایل جاسازی‌شده در سند PDF را مدیریت می‌کند. برای شمارش پیوست‌ها از size() استفاده کنید.

try (Document doc = new Document("document.pdf")) {
    EmbeddedFileCollection files = doc.getEmbeddedFiles();
    int count = files.size();
    System.out.println("Embedded files: " + count);
}

تعداد صفحات

از PageCollection.getCount() یا PageCollection.size() برای تعیین تعداد کل صفحات یک سند استفاده کنید:

try (Document doc = new Document("input.pdf")) {
    int pageCount = doc.getPages().getCount();
    System.out.println("Total pages: " + pageCount);
}

همچنین ببینید:

 فارسی