เมธอดขั้นสูงของ THPDFPage

หน้านี้รวบรวมเมธอดในระดับหน้ากระดาษที่เป็นสาธารณะใน THPDFPage และมีประโยชน์ในเวิร์กโฟลว์การเขียนขั้นสูง แต่ยังไม่มีหน้าหัวข้อแยกต่างหาก

คำอธิบายประกอบการทำเครื่องหมายและริช

Method Use
AddHighlightAnnotation, AddUnderlineAnnotation, AddSquigglyAnnotation, AddStrikeOutAnnotation สร้างคำอธิบายประกอบการทำเครื่องหมายข้อความเหนือขอบเขตข้อความสี่เหลี่ยม HotPDF จะส่งออกประเภทย่อย PDF 1.7 ที่ตรงกันและดึงค่า /QuadPoints จากสี่เหลี่ยม
AddPolylineAnnotation, AddPolygonAnnotation สร้างคำอธิบายประกอบสำหรับการตรวจสอบแบบเส้นหลายจุดหรือรูปหลายเหลี่ยมของ PDF 1.7 จากอาร์เรย์ของจุดยอด THPDFCurrPoint ส่วนการโอเวอร์โหลดด้วย THPDFPolyExtras จะเพิ่มรายละเอียดสีภายใน ขอบเขตคล้ายเมฆ วัตถุประสงค์ และจุดสิ้นสุดเส้นที่เป็นตัวเลือก
HPDFDefaultLineExtras, HPDFDefaultPolyExtras ส่งคืนเรกคอร์ด THPDFLineExtras และ THPDFPolyExtras ที่ถูกเตรียมค่าเป็นศูนย์ เพื่อให้ผู้เรียกสามารถตั้งค่าเฉพาะฟิลด์คำอธิบายประกอบเส้นหรือรูปหลายเหลี่ยมที่เป็นตัวเลือกที่ต้องการได้
AddInkAnnotation, AddCaretAnnotation เพิ่มเครื่องหมายการตรวจสอบแบบวาดด้วยมือหรือเครื่องหมายการแทรกแคเรต ใช้ LastAnnotation ร่วมกับ SetAnnotationBorderStyle เมื่อต้องปรับแต่งรูปแบบเส้นขอบหลังจากสร้างขึ้น
AddScreenAnnotation, AddWatermarkAnnotation, AddRedactAnnotation เพิ่มหน้าจอมัลติมีเดีย ลายน้ำแบบพิมพ์คงที่ หรือคำอธิบายประกอบเพื่อการปิดบังข้อมูล วิธีการเหล่านี้ใช้เกณฑ์เวอร์ชัน PDF และข้อกำหนดการปฏิบัติตามข้อกำหนดแบบเดียวกันกับประเภทย่อยของคำอธิบายประกอบที่สอดคล้องกัน
Add3DAnnotation, AddRichMediaAnnotation เพิ่มคำอธิบายประกอบสื่อเชิงโต้ตอบสำหรับ PDF 1.7 สิ่งเหล่านี้มีไว้สำหรับเวิร์กโฟลว์ของโปรแกรมดูที่รองรับเนื้อหา 3D หรือริชมีเดียแบบฝังตัวอย่างชัดเจน และไม่เหมาะสำหรับเอาต์พุต PDF/A สำหรับการเก็บถาวร
AddPopupAnnotation สร้างคำอธิบายประกอบแบบป๊อปอัปโดยตรง เมื่อควรแนบป๊อปอัปเข้ากับคำอธิบายประกอบอื่น ควรเลือกใช้ AddPopupAnnotationFor

ส่วนขยายการดำเนินการของปุ่ม

Method คำอธิบาย
AddPushButtonWithHideAction สร้างปุ่มกดที่การดำเนินการจะซ่อนหรือแสดงฟิลด์ฟอร์มอย่างน้อยหนึ่งฟิลด์ สิ่งนี้มีประโยชน์เมื่อฟอร์มต้องการส่วนเสริมโดยไม่ต้องรันโค้ด JavaScript
AddPushButtonWithSubmitAction สร้างปุ่มส่งข้อมูลพร้อมค่า THPDFSubmitFormFlags ที่ชัดเจน เพื่อให้ผู้เรียกควบคุมตัวเลือก FDF, HTML, XFDF, PDF, GET/POST และการส่งข้อมูลที่เกี่ยวข้องได้
AddPushButtonWithRenditionAction สร้างปุ่มกดที่ควบคุมการดำเนินการแสดงผลที่ผูกกับคำอธิบายประกอบหน้าจอและไฟล์สื่อ โหมดการปฏิบัติตามข้อกำหนด PDF/A และ PDF/X จะปฏิเสธการดำเนินการมัลติมีเดีย
AddPushButtonWithSoundAction สร้างปุ่มกดที่เล่นไฟล์เสียง /Sound ของ PDF แบบฝัง ตัวเลือกโอเวอร์โหลดจะยอมรับทั้งชื่อไฟล์หรือไบต์เสียงดิบที่ผู้เรียกจัดเตรียมให้พร้อมด้วย THPDFSoundParams
AddPushButtonWithMovieAction สร้างปุ่มการดำเนินการภาพยนตร์แบบดั้งเดิมที่อ้างอิงถึงพจนานุกรมที่ส่งกลับโดย AddMovieAnnotation

กล่องหน้าและส่วนควบคุมการแสดงผล

Method or property คำอธิบาย
SetCropBox, SetBleedBox, SetTrimBox, SetArtBox แนบกล่องหน้าสำหรับงานผลิตที่เป็นตัวเลือกซึ่งกำหนดโดย ISO 32000-1 §14.11.2 โดย MediaBox ยังคงติดตามขนาดกระดาษจริง ส่วนกล่องที่ไม่ได้ตั้งค่าจะถอยกลับไปใช้ตามลู่วิ่งเริ่มต้นมาตรฐานของ PDF
SetPageRotation ตั้งค่ารายการ /Rotate ของหน้า ค่าจะถูกปรับให้เป็นจำนวนเท่าของ 90 องศาตามที่ PDF กำหนดในขอบเขต 0..359
SetUserUnit ตั้งค่า /UserUnit ของ PDF 1.6 สำหรับหน้ากระดาษขนาดใหญ่มาก การส่งค่า 0 จะเป็นการเอาข้อมูลออกและทำให้หน้ากระดาษกลับไปใช้มาตราส่วนหน่วยเริ่มต้น
SetTabsOrder ตั้งค่าลำดับแท็บคำอธิบายประกอบหน้าผ่านทางรายการ /Tabs ใช้ R, C, S, A หรือ W ตามที่กำหนดโดยข้อกำหนดเฉพาะของ PDF
DocScale ปรับขนาดการวาดหน้ากระดาษที่ใช้โดยเส้นทางการวาดเพื่อความเข้ากันได้ ปล่อยไว้เป็นค่าเริ่มต้นเว้นแต่ผู้เรียกต้องการพิกัดเดิมที่มีการปรับขนาดโดยเจตนา

ความโปร่งใสและเนื้อหาทางเลือก

Method คำอธิบาย
SetTransparencyGroup, SetTransparencyGroupICC, ClearTransparencyGroup แนบหรือเอาพจนานุกรม /Group ของหน้าออกเพื่อให้เนื้อหาที่มีข้อมูลอัลฟารวมกันเป็นกลุ่มความโปร่งใสของ PDF รุ่น ICC อ้างอิงถึงโปรไฟล์ ICC ที่ลงทะเบียนในเอกสาร
BeginOptionalContent, EndOptionalContent ห่อหุ้มการวาดหน้ากระดาษถัดไปในลำดับเนื้อหาที่ทำเครื่องหมายของเนื้อหาทางเลือกสำหรับ PDF 1.5 ลงทะเบียนเลเยอร์ก่อนด้วย THotPDF.RegisterOptionalContentGroup

เนื้อหาที่มีแท็กและแบบอักษร Type 3

Method คำอธิบาย
BeginMarkedContentMCIDProps เริ่มต้นลำดับเนื้อหาที่ทำเครื่องหมายด้วยพจนานุกรมคุณสมบัติแบบอินไลน์ที่มี /MCID รวมถึงรายการตัวเลือก /Lang, /Alt, /ActualText และ /E ใช้ EndMarkedContent เพื่อปิดลำดับ
SetType3Font เลือกแบบอักษร Type 3 ที่ลงทะเบียนผ่าน THotPDF.RegisterType3Font เพื่อให้การเรียกใช้ ShowText ในภายหลังส่งออกข้อความด้วยสตรีมกลิฟที่ผู้เรียกกำหนด

การกำหนดตำแหน่งข้อความและตัวช่วยความเข้ากันได้

Method คำอธิบาย
SetCharacterSpacing, SetTextMatrix, MoveToNextLine ส่งออกตัวดำเนินการตำแหน่งและสถานะข้อความ PDF ระดับต่ำสำหรับผู้เรียกที่ต้องการการควบคุมโดยตรงนอกเหนือจาก TextOut, UnicodeTextOut หรือตัวช่วยกล่องข้อความ
SetRGBHyperlinkColor ตั้งค่าสี RGB ที่ใช้โดย PrintHyperlink คุณสมบัติ HyperlinkColor ที่เผยแพร่จะเรียกใช้ตัวตั้งค่านี้
FMEllipse, MFRectangle นามแฝงการวาดแบบเดิมยังคงอยู่เพื่อความเข้ากันได้ย้อนหลังกับโค้ดผู้เรียกที่เก่ากว่า สำหรับโค้ดใหม่ ควรเลือกใช้ Ellipse และ Rectangle
DirectDrawBarcode วาดบาร์โค้ดโดยใช้พิกัดหน้ากระดาษโดยตรงและชนิดบาร์โค้ดที่เป็นตัวเลข สำหรับโค้ดที่ระบุชนิดข้อมูล ควรเลือกใช้ DrawBarcode ร่วมกับรหัสแจกแจง THPDFBarcodeType
TextOutStr, OutText, RtLTextOutStr, SetFontAndSize, ShowMetafileEx นามแฝงเพื่อความเข้ากันได้หรือจุดเชื่อมต่อเฉพาะของ C++Builder ที่ยังคงพร้อมใช้งานสำหรับโค้ดที่มีอยู่ โค้ดใหม่มักจะสามารถใช้ TextOut, RtLTextOut, SetFont และ ShowMetafile
Debug_GetProcessedRtlString, ProcessFont ตัวช่วยวินิจฉัยและตัวช่วยระดับต่ำที่เปิดเผยจากคลาส สิ่งเหล่านี้ได้รับการบันทึกไว้ที่นี่เพื่อให้มองเห็น API ได้ การสร้างเอกสารตามปกติควรใช้เมธอดข้อความและแบบอักษรในระดับที่สูงกว่า

ตัวช่วยฟิลด์ลายเซ็นดิจิทัล

AttachPAdESSeedValue - แนบพจนานุกรมค่าเริ่มต้น PAdES เข้ากับฟิลด์ลายเซ็นที่มีอยู่ เพื่อให้โปรแกรมดูสามารถแสดงข้อจำกัดของไดเจสต์, ตัวกรองย่อย, เหตุผล, สถานที่, ข้อมูลติดต่อ, การประทับเวลา และใบรับรองก่อนการลงลายเซ็น สร้างฟิลด์ด้วย AddPAdESSignatureField หรือตัวช่วยฟิลด์ลายเซ็นอื่นๆ ก่อน จากนั้นจึงเรียก AttachPAdESSeedValue ด้วยชื่อฟิลด์และการตั้งค่า THPDFPAdESSeedValue

ดูเพิ่มเติม

  • เมธอด THPDFPage
  • คุณสมบัติของ THPDFPage
  • THPDFPage.SetPageThumbnail / ClearPageThumbnail
  • THPDFPage.AddTextWatermark
  • การรองรับตัวกรอง PDF