เอกสารอ้างอิงสำหรับนักพัฒนา PDFiumPas

ภาพรวมผลิตภัณฑ์

PDFiumPas คือไลบรารีคอมโพเนนต์ระดับมืออาชีพแบบครบวงจร ที่นำความสามารถด้านการประมวลผลและการดู PDF อันทรงพลังมาสู่แอปพลิเคชัน Delphi และ C++Builder สร้างขึ้นบนเอนจินเรนเดอร์ PDFium ที่แข็งแกร่งของ Google จึงมอบโซลูชันครบชุดสำหรับการผสานฟังก์ชัน PDF เข้ากับแอปเดสก์ท็อปของคุณ

ไลบรารีนี้ประกอบด้วยคอมโพเนนต์หลักสองตัวที่ทำงานร่วมกันอย่างราบรื่น: TPdf สำหรับงานประมวลผลและจัดการเอกสาร และ TPdfView สำหรับการนำเสนอแบบโต้ตอบ ไม่ว่าคุณจะต้องสร้างโปรแกรมดู PDF แบบเรียบง่าย ระบบจัดการเอกสารที่ซับซ้อน หรือผสานความสามารถ PDF เข้ากับแอปที่มีอยู่แล้ว PDFiumPas ก็มีเครื่องมือและความยืดหยุ่นที่คุณต้องการ

คอมโพเนนต์หลัก

คอมโพเนนต์ TPdf - เอนจินประมวลผลเอกสาร

หัวใจของระบบประมวลผล PDF โดย TPdf จัดการงานระดับเอกสารทั้งหมด รวมถึงการโหลด การบันทึก การดึงข้อความ การประมวลผลฟอร์ม และการจัดการข้อมูลเมตา

การจัดการเอกสาร: เปิดจากไฟล์ สตรีม หรือบัฟเฟอร์หน่วยความจำ
การประมวลผลข้อความ: ความสามารถขั้นสูงสำหรับการดึงข้อความและการค้นหา
การจัดการฟอร์ม: รองรับฟอร์มแบบโต้ตอบอย่างครบถ้วนพร้อม JavaScript
ความปลอดภัย: รองรับ PDF ที่ป้องกันด้วยรหัสผ่านและการจัดการสิทธิ์
การเข้าถึงข้อมูลเมตา: ดึงคุณสมบัติและข้อมูลของเอกสารได้ครบถ้วน

คอมโพเนนต์ TPdfView - คอนโทรลสำหรับดูแบบโต้ตอบ

คอนโทรลภาพที่ซับซ้อนและครบเครื่อง ซึ่งมอบประสบการณ์การดู PDF ที่สมบูรณ์พร้อมความสามารถในการโต้ตอบกับผู้ใช้ได้เต็มที่

การเรนเดอร์คุณภาพสูง: การแสดงผลที่ปรับแต่งมาแล้วพร้อมโหมดเรนเดอร์หลายแบบ
การนำทางแบบโต้ตอบ: ซูม เลื่อน หมุน และไปยังหน้าต่าง ๆ
การเลือกข้อความ: เลือก คัดลอก และจัดการเนื้อหาข้อความ
การแสดงคำอธิบายประกอบ: ดูและโต้ตอบกับคำอธิบายประกอบใน PDF
เมาส์ & คีย์บอร์ด: รองรับอุปกรณ์รับข้อมูลครบถ้วนพร้อมการแมปพิกัด

คุณลักษณะและความสามารถหลัก

การประมวลผลเอกสาร

โหลดเอกสาร PDF จากไฟล์ สตรีม บัฟเฟอร์หน่วยความจำ หรือผ่านตัวแปลง TStream แบบเรียกใช้เมื่อจำเป็นด้วย LoadCustomDocument
บันทึกและส่งออกเอกสารพร้อมตัวเลือกหลากหลาย (incremental, remove security, ระบุ PDF เวอร์ชันเป้าหมายอย่างชัดเจน)
ตัวตรวจสอบความสอดคล้องของเวอร์ชัน PDF จะปฏิเสธฟีเจอร์ที่ใหม่กว่าระดับเป้าหมายที่เลือกไว้ (PDF 1.0 - 1.7)
สร้าง PDF/A-1b ผ่าน SaveAsPdfA / SaveAsPdfAToStream พร้อมโปรไฟล์ sRGB ICC ที่มาพร้อมกับไลบรารีและการรองรับโปรไฟล์แบบกำหนดเอง
ตรวจสอบ PDF/A ผ่าน ValidatePdfA และพร็อพเพอร์ตีแบบอ่านอย่างเดียว PdfAConformance
จัดการ PDF ที่ป้องกันด้วยรหัสผ่านและเข้ารหัสแล้ว
จัดการข้อมูลเมตาและพร็อพเพอร์ตีของเอกสาร
การจัดองค์ประกอบหน้า: ImportPagesByIndex (นำเข้าบางหน้า), ImportNPagesToOne (จัดหน้าแบบ N-up), MovePages (จัดเรียงใหม่ในที่เดิม)
การนำหน้าแบบ Form XObject กลับมาใช้ซ้ำ: ปั๊มหน้าหนึ่งไปยังหลายหน้าได้ด้วย CreateXObjectFromPage และ InsertFormObjectFromXObject
รองรับบุ๊กมาร์กและปลายทาง
การ flatten ฟอร์ม: สร้าง appearance streams (/AP) ใหม่จากค่าของฟิลด์ แล้วฝังคำอธิบายประกอบและวิดเจ็ตของฟอร์มให้กลายเป็นเนื้อหาคงที่บนหน้า

การทำงานกับข้อความและเนื้อหา

ดึงข้อความขั้นสูงพร้อมคงรูปแบบไว้
ค้นหาข้อความได้ทรงพลังพร้อมตัวเลือกหลากหลาย
วิเคราะห์และระบุตำแหน่งข้อความระดับตัวอักษร
เข้าถึงข้อมูลและพร็อพเพอร์ตีของฟอนต์
การเลือกข้อความและการทำงานกับคลิปบอร์ด
รองรับหลายภาษาและ Unicode

ฟอร์มแบบโต้ตอบและคำอธิบายประกอบ

รองรับฟิลด์ฟอร์มแบบโต้ตอบอย่างครบถ้วน
ฟิลด์ข้อความ เช็กบ็อกซ์ ปุ่มตัวเลือก และคอมโบบ็อกซ์
การตรวจสอบฟอร์มและการทำงานของ JavaScript
การแสดงและโต้ตอบกับคำอธิบายประกอบ
คำอธิบายประกอบลิงก์และลิงก์เว็บ
รองรับลายเซ็นดิจิทัล

การเรนเดอร์และการแสดงผลภาพ

การเรนเดอร์แบบ anti-alias คุณภาพสูง พร้อมการเขียนแบบตรงลงในบัฟเฟอร์ DIB ปลายทางโดยไม่ต้องคัดลอกซ้ำ
การเรนเดอร์แบบ progressive ที่ยกเลิกได้ผ่าน RenderPageProgressive และ IPdfCancellationToken
โหมดการแสดงผลหลายแบบ (ต่อเนื่องหน้าเดียว ต่อเนื่องสองหน้า และสองหน้าพร้อมหน้าปก)
FitMode เลือกวิธีวางหน้าลงใน viewport (ซูมด้วยตนเอง ขนาดจริง พอดีกับหน้า พอดีกับความกว้าง) และจะถูกนำมาใช้ใหม่อัตโนมัติเมื่อ Resize หรือเปลี่ยนหน้า
PageColor แยกพื้นหลังของหน้า PDF ที่เรนเดอร์ออกจาก Color ของคอนโทรลรอบข้าง เพื่อรองรับ viewer โหมดมืด
ไฮไลต์ผลการค้นหาผ่าน HighlightSearchText และ ClearHighlight
เงาตกกระทบแบบเลือกเปิดได้ (PageShadowSize / PageShadowColor) และเส้นขอบหน้า (PageBorderColor)
การจัดการการคลิกลิงก์อย่างปลอดภัยพร้อมรายการอนุญาตแยกตามการกระทำ (LinkOptions) และอีเวนต์ OnAnnotationLinkClick / OnWebLinkClick
การล็อกการรับข้อมูลจากผู้ใช้ (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) สำหรับ kiosk และการฝังแบบอ่านอย่างเดียว
การนำทางภาพขนาดย่อผ่านคอมโพเนนต์แถบด้านข้าง TPdfThumbnailView
การเรนเดอร์ข้อความที่ปรับแต่งเพื่อ LCD
ผลลัพธ์คุณภาพสำหรับการพิมพ์ พร้อมโหมดพิมพ์ของ PDFium ที่เลือกได้ (EMF, text-only, PostScript Level 2 / 3, pass-through, image-mask, Type 42)
การเรนเดอร์สีและระดับเทาแบบกำหนดเอง

คุณลักษณะที่เป็นมิตรกับนักพัฒนา

ระบบอีเวนต์ครบถ้วนสำหรับการปรับแต่ง
การแมปพิกัดระหว่างหน้าจอกับ PDF อย่างแม่นยำ
พร็อพเพอร์ตีและเมธอด API จำนวนมาก
รองรับขณะออกแบบพร้อม property editor
การทำงานแบบปลอดภัยต่อเธรดในกรณีที่รองรับ
การประมวลผลที่ใช้หน่วยความจำอย่างมีประสิทธิภาพสำหรับเอกสารขนาดใหญ่

ข้อกำหนดทางเทคนิค

ด้าน	รายละเอียด
เอนจินเรนเดอร์	Google PDFium - เอนจิน PDF มาตรฐานอุตสาหกรรมที่ผ่านการใช้งานจริงอย่างกว้างขวาง
การรองรับ PDF	PDF เวอร์ชัน 1.0 ถึง 1.7 รวมถึงไฟล์ที่เข้ารหัสและป้องกันด้วยรหัสผ่าน
ความเข้ากันได้ของแพลตฟอร์ม	แอปพลิเคชัน Windows แบบ 32-bit และ 64-bit
การรองรับ IDE	Delphi XE5 / C++Builder XE5 (RAD Studio XE5) ไปจนถึง Delphi/C++Builder 13.1 Florence (RAD Studio 13.1), Lazarus 3.8+
การเข้ารหัสอักขระ	รองรับ Unicode เต็มรูปแบบ พร้อมการประมวลผลข้อความหลายภาษา
การจัดการหน่วยความจำ	ปรับให้เหมาะกับเอกสารขนาดใหญ่ ใช้ทรัพยากรอย่างมีประสิทธิภาพ
ความปลอดภัยของเธรด	ออกแบบให้ทำงานแบบ single-threaded (ตามข้อกำหนดของ PDFium)

การออกแบบสถาปัตยกรรม

PDFiumPas ใช้รูปแบบสถาปัตยกรรมแบบแบ่งชั้น ซึ่งแยกความรับผิดชอบออกจากกันอย่างชัดเจนและเพิ่มการนำโค้ดกลับมาใช้ซ้ำได้สูงสุด

สถาปัตยกรรมแบบแบ่งชั้น

ชั้น	ไฟล์	ความรับผิดชอบ
คอมโพเนนต์ VCL	PDFium.pas, FPdfThumbnail.pas	คอมโพเนนต์ Delphi VCL (TPdf, TPdfView, TPdfThumbnailView) พร้อมการสนับสนุนขณะออกแบบ
ตระกูลมีและการและโหมดมีและการของการอ้างของการอิงสำหรับการของและการแบบการแบบสำหรับการสำหรับการของการตระกูลสำหรับแบบผูกโหมดและอ้างสำหรับมีและการโหมดสำหรับตระกูลระบบ `API` (API Bindings)	FPdfView.pas, FPdfDoc.pas, FPdfText.pas, FPdfEdit.pas, FPdfAnnot.pas, FPdfFormFill.pas, FPdfPageOps.pas, FPdfAttachment.pas, FPdfSignature.pas, FPdfStructTree.pas, FPdfDataAvail.pas, FPdfExtensions.pas, FPdfFWLEvent.pas, FPdfCompress.pas, FPdfUtils.pas	การประกาศฟังก์ชันพอยน์เตอร์สำหรับการเรียก PDFium DLL
ตระกูลของแบบโหมดและสำหรับการและกระบวนมีของและและและการของตระกูลทำงานของโหมดโหมดของอ้างและแบบในและแบบเพื่อไปป์ไลน์โหมดอิงแบบการมีในตระกูลอ้างสำหรับและการสำหรับและการมีอ้างแบบของ `PDF/A` (PDF/A Pipeline)	FPdfPdfa.pas	การสร้าง PDF/A-1b (XMP injection, sRGB ICC OutputIntent, การอัปเดต catalog) และการตรวจสอบ (ตรวจจับความสอดคล้อง, แจงปัญหา)
ตระกูลสำหรับสำหรับในหรือและและโหมดมีหรือการโหมดแบบสำหรับโครงสร้างมีการตระกูลมีและสำหรับและตระกูลโหมดในและการของและระบบของการโหมดและสำหรับและแบบและพื้นฐานและมีโหมดตระกูลอ้างแบบตระกูลอ้างทำงานและและแบบในและแบบ `Async` (Async Infrastructure)	FPdfAsync.pas	IPdfCancellationToken / IPdfCancellationTokenSource, singleton PdfNoCancellationToken และตัวช่วย TPdfFuture<T> สำหรับงานเรนเดอร์และส่งออกที่ใช้เวลานาน
ระบบตัวช่วยในเกี่ยวกับเรขาคณิต (Geometry Helpers)	FPdfMatrix.pas	wrapper แบบ OO รอบ FS_MATRIX พร้อมตัวช่วย Translate, Scale, Rotate, Flip, Skew และ Multiply
ระบบปฏิบัติการบนโหมดตระกูลหน้าตระกูลกระดาษของการของ (Page Operations)	FPdfPageOps.pas	wrapper สำหรับ FPDF_ImportPagesByIndex, FPDF_ImportNPagesToOne, FPDF_MovePages และตัวช่วย Form-XObject (CreateXObjectFromPage / InsertFormObjectFromXObject)
พาเนลแสดงผลแบบจำพวกรูปย่ออิงด้านข้าง (Thumbnail Side Panel)	FPdfThumbnail.pas	TPdfThumbnailView — แผงภาพขนาดย่อรายหน้าที่เลื่อนได้ พร้อม hover, selection และการนำทาง OnPageClick
โหมดสำหรับการของสำหรับในและตระกูลเอนจินแบบสำหรับและแบบและการสำหรับการโหมดมีของโหมดแบบในมีตระกูลแบบของการแบบสำหรับการเนทีฟโหมดการสำหรับการ (Native Engine)	DLLs\Win32\|Win64\pdfium.dll และ pdfium.v8.dll	เอนจินเรนเดอร์ดั้งเดิมของ Google PDFium พร้อมบิลด์ที่เปิดใช้ V8 เป็นตัวเลือก

ลำดับชั้นของคอมโพเนนต์

TPdf (TComponent) - คอมโพเนนต์แบบไม่แสดงผลสำหรับงานเอกสาร PDF
TPdfView (TScrollingWinControl) - คอนโทรลภาพที่สืบทอดความสามารถด้านการเลื่อนและโฟกัส
TPdfThumbnailView (TCustomControl) - แผงนำทางภาพขนาดย่อแบบเลื่อนได้ที่เชื่อมกับคอมโพเนนต์ TPdf

รูปแบบการออกแบบสำคัญ

โหลด DLL แบบไดนามิก: โหลดฟังก์ชัน PDFium ในขณะรันไทม์ผ่าน GetProcAddress
ทรัพยากรแบบ handle: จัดการเอกสาร PDF หน้า และออบเจ็กต์ผ่าน handle แบบทึบ
สถาปัตยกรรมขับเคลื่อนด้วยอีเวนต์: อีเวนต์จำนวนมากสำหรับการโต้ตอบกับฟอร์ม การเปลี่ยนหน้า และการเรนเดอร์
ชนิดข้อมูลแบบ record: โครงสร้างข้อมูลซับซ้อนถูกเปิดเผยเป็น Delphi records (TBookmark, TDestination, TPdfAnnotation, etc.)
ตัวช่วยแบบเลือกใช้: FPdfAsync และ FPdfMatrix มอบยูทิลิตีสำหรับการยกเลิก/future และการแปลง โดยไม่บังคับให้รวมเข้าไปในคอมโพเนนต์ TPdf หลัก

สถานการณ์การใช้งาน

แอปพลิเคชันธุรกิจ

ระบบจัดการเอกสาร: ดู จัดระเบียบ และประมวลผลเอกสาร PDF
ตัวดูรายงาน: แสดงรายงานที่สร้างขึ้นและเอกสารธุรกิจ
การประมวลผลฟอร์ม: จัดการฟอร์ม PDF แบบโต้ตอบและการเก็บข้อมูล
ระบบจัดเก็บถาวร: เข้าถึงและแสดงเอกสาร PDF เก่า

การศึกษาและงานวิจัย

แพลตฟอร์มการเรียนรู้ออนไลน์: แสดงสื่อการเรียนและตำรา
เครื่องมือวิจัย: วิเคราะห์และดึงข้อมูลจากบทความวิชาการ
ห้องสมุดดิจิทัล: เรียกดูและค้นหาคอลเล็กชันเอกสาร
แอปจดบันทึก: ใส่คำอธิบายประกอบและไฮไลต์เนื้อหา PDF

กฎหมายและการปฏิบัติตามข้อกำหนด

ตรวจเอกสารทางกฎหมาย: ตรวจสอบสัญญาและเอกสารทางกฎหมาย
ระบบการปฏิบัติตามข้อกำหนด: ตรวจสอบความสมบูรณ์ของเอกสารและลายเซ็น
การจัดการคดี: จัดระเบียบและทบทวนเอกสารทางกฎหมาย
เครื่องมือสอบทาน: ประมวลผลและวิเคราะห์เอกสารด้านกฎระเบียบ

เทคนิคและวิศวกรรม

ตัวดู CAD: แสดงแบบร่างและสเปกทางเทคนิค
ระบบคู่มือ: เข้าถึงคู่มือการบำรุงรักษาและการใช้งาน
การควบคุมคุณภาพ: ตรวจสอบรายงานทดสอบและใบรับรอง
การจัดการโครงการ: จัดการเอกสารและแผนงานโครงการ

ข้อดีและประโยชน์

ประสิทธิภาพและความน่าเชื่อถือ

เทคโนโลยีที่พิสูจน์แล้ว: สร้างบนเอนจิน PDFium ของ Google ที่ Chrome ใช้งานอยู่
ประสิทธิภาพสูง: การเรนเดอร์และการจัดการหน่วยความจำที่ปรับมาอย่างดี
เสถียรภาพ: ผ่านการทดสอบอย่างกว้างขวางกับเอกสาร PDF หลายพันฉบับ
ปรับขนาดได้: รองรับทั้งฟอร์มขนาดเล็กและเอกสารหลายหน้าขนาดใหญ่

คุณค่าทางธุรกิจ

พัฒนาได้รวดเร็ว: API ที่ครอบคลุมช่วยลดเวลาพัฒนา
ปลอดค่าลิขสิทธิ์: ไม่มีค่ารันไทมหรือความซับซ้อนด้านไลเซนส์
มีซอร์สโค้ดรวม: ปรับแต่งและดีบักได้เต็มที่
รองรับระยะยาว: มีอัปเดตสม่ำเสมอและดูแลความเข้ากันได้

ประสบการณ์ของนักพัฒนา

ติดตั้งใช้งานได้ง่าย: คอมโพเนนต์แบบนำไปใช้ได้ทันทีพร้อมการตั้งค่าน้อยที่สุด
เอกสารครบถ้วน: ไฟล์ช่วยเหลือและตัวอย่างที่ครอบคลุม
ขับเคลื่อนด้วยอีเวนต์: ปรับแต่งได้ยืดหยุ่นผ่านอีเวนต์จำนวนมาก
รองรับขณะออกแบบ: property editor และการผสานกับ IDE

สำรวจเพิ่มเติม

หน้าแรกเอกสาร - จุดเริ่มต้นสำหรับการนำทางบนเว็บ
คู่มือเริ่มต้นใช้งานด่วน - เริ่มใช้งานได้ภายในไม่กี่นาที
คำแนะนำการติดตั้ง - การตั้งค่าและการกำหนดค่า
ตัวอย่างโค้ด - สถานการณ์การใช้งานจริง
เอกสารอ้างอิง API ฉบับสมบูรณ์ - เอกสารคอมโพเนนต์ฉบับเต็ม
คอมโพเนนต์ TPdf - รายละเอียดการประมวลผลเอกสาร
คอมโพเนนต์ TPdfView - รายละเอียดคอนโทรลสำหรับดู

ไลบรารีคอมโพเนนต์ PDFiumPas