Facades API ile Aspose.PDF FOSS for C++'de Nasıl Çalışılır

Aspose.PDF FOSS for C++ yüksek seviyeli arabirim ve düzenleyici sınıflarını — PdfExtractor, PdfBookmarkEditor, PdfContentEditor, PdfAnnotationEditor, FormEditor, PdfFileEditor ve PdfConverter dahil — Aspose::Pdf::Facades ad alanında gruplar. Her biri, temel Document API üzerine tek bir belge bakım görevini kapsar, böylece içeriği çıkarabilir, yer imlerini düzenleyebilir veya form alanlarını doldurabilirsiniz; alttaki sayfa ve nesne yürüyüşlerini kendiniz el ile kodlamadan. Bu rehber, mevcut bir PDF’ten gömülü dosya eklerini, sayfa metnini ve gömülü görselleri çıkarmak için kullanılan PdfExtractor arabirimine odaklanır.

Adım Adım Rehber

git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-Cpp.git

add_subdirectory(Aspose.PDF-FOSS-for-Cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

cmake -S . -B build
cmake --build build

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/facades/pdf_extractor.hpp>

using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

Document doc("input.pdf");
PdfExtractor extractor(doc);

#include <iostream>

if (doc.EmbeddedFiles().Count() > 0) {
    std::vector<std::string> names = extractor.GetAttachNames();
    for (const auto& name : names) {
        std::cout << "Attachment: " << name << "\n";
    }

    // Writes the bytes of the first attachment to disk
    extractor.GetAttachment("extracted_attachment.bin");
}

extractor.ExtractText();
extractor.GetText("extracted_text.txt");

extractor.StartPage(1);
extractor.EndPage(doc.Pages().Count());

int pageNumber = extractor.StartPage();
while (extractor.HasNextPageText()) {
    std::string outputFile = "page_" + std::to_string(pageNumber) + ".txt";
    extractor.GetNextPageText(outputFile);
    ++pageNumber;
}

extractor.ExtractImage();

int imageIndex = 1;
while (extractor.HasNextImage()) {
    std::string outputFile = "extracted_image_" + std::to_string(imageIndex);
    if (extractor.GetNextImage(outputFile)) {
        ++imageIndex;
    }
}

Yaygın Sorunlar ve Çözümler

GetAttachNames() boş bir vektör döndürür. Kaynak PDF’de gömülü dosya yok. Kontrol edin doc.EmbeddedFiles().Count() herhangi bir ek yöntemi çağırmadan önce PdfExtractor böylece ekleri hiç olmayan bir belgeden çıkarmaya çalışmazsınız.

Sayfa metni döngüsü hiçbir zaman gövdeye girmez. HasNextPageText() returns false hemen eğer StartPage() / EndPage() hiç ayarlanmamışsa, ya da belge sayfasının gerçek sayısını aşan bir aralığa ayarlanmışsa. Aralığı açıkça şu konumdan ayarlayın doc.Pages().Count() kontrol etmeden önce HasNextPageText().

GetNextImage() returns false ilk çağrıda. ExtractImage() kontrol etmeden önce görsel imlecini hazırlamak için bir kez çağrılmalıdır HasNextImage() veya çağır GetNextImage(). Çağırma GetNextImage() önceden bir ExtractImage() çağrı, çağıranın bakış açısından tanımsızdır — her zaman çağır ExtractImage() ilk.

Her çıkarılan görsel veya sayfa-metni dosyası bir önceki dosyanın üzerine yazar. GetNextImage() and GetNextPageText() her biri gerçek bir çıktı yolu alır; facade sizin için benzersiz dosya adları oluşturmaz. Adım 5 ve 6’da gösterildiği gibi, her yineleme için ayrı bir yol oluşturun (örneğin, artan bir sayaç ekleyerek).

Bağlantı hatası: tanımsız referans aspose_pdf_foss semboller. Confirm add_subdirectory() klonlanmış depo köküne işaret eder ve bu target_link_libraries() adlandırır aspose_pdf_foss hedefi tam olarak, C++20 standardı yapılandırılmış şekilde your_app.

Sıkça Sorulan Sorular

API Facadeları ile temel Document API arasındaki fark nedir?

Temel Document API (Document, PageCollection, Annotation vb.) PDF nesne modelini doğrudan ortaya çıkarır. PdfExtractor gibi facade sınıfları bunun üzerine oturur ve belirli çok-adımlı bir görevi — içeriği çıkarma, yer imlerini düzenleme, form alanlarını doldurma — daha dar, amaca yönelik bir arayüzün arkasına paketler.

PdfExtractor ile içerik çıkarttığım aynı şekilde yer imlerini düzenleyebilir veya form alanlarını doldurabilir miyim?

Evet. PdfBookmarkEditor (CreateBookmarks(), ModifyBookmarks(), ExtractBookmarks() ve DeleteBookmarks() ile) ve FormEditor (AddField(), RemoveField() ve SetFieldAttribute() ile) aynı Aspose::Pdf::Facades ad alanında bulunur ve Adım 2 ve 3’te gösterilen aynı include/construct desenini izler — her biri yalnızca belgenin farklı bir bölümü üzerinde çalışır.

PdfExtractor şifre korumalı bir PDF’i okuyabilir mi?

Herhangi bir çıkarma yöntemini çağırmadan önce şifreyi ayarlayın:

extractor.Password("owner-or-user-password");

PdfExtractor::Password() basit bir okuma/yazma özelliğidir, bu yüzden ExtractText(), ExtractImage() veya ekleme yöntemlerinden önce ayarlanmalıdır.

PDF’de çıkarılacak metin, resim veya ek yoksa ne olur?

Hiçbir şey hata atmaz. GetAttachNames() boş bir vektör döndürür ve HasNextPageText() / HasNextImage() ilk kontrolde false döndürür, bu yüzden ilgili döngü gövdesi hiç çalışmaz.

Belirli bir facade sınıfı için hangi başlık dosyasını dahil etmeliyim?

Her facade sınıfı, aspose/pdf/facades/ altında, sınıf adıyla eşleşen kendi başlık dosyasını getirir: pdf_extractor.hpp PdfExtractor için, pdf_bookmark_editor.hpp PdfBookmarkEditor için, form_editor.hpp FormEditor için, ve bookmark.hpp Bookmark / Bookmarks değer tipleri için.

Ayrıca Bakınız

• Hızlı Başlangıç — Aspose.PDF FOSS for C++
• Belge, Sayfa ve İşleme Temelleri
• PdfExtractor Sınıf Referansı
• Aspose.PDF FOSS for C++ Ürün Sayfası
• Aspose.PDF for C++ — Enterprise Knowledge Base