PDFium Delphi Component Docs

เมธอด SetPageObjectMarkParam

Component: TPdf  ·  Unit: PDFium

Syntax

procedure SetPageObjectMarkParam(Index, MarkIndex: Integer; const Param: TPdfContentMarkParam);

Description

เพิ่มหรือแทนที่คุณสมบัติหนึ่งรายการบนรายการ marked-content ที่มีอยู่ผ่าน mark handle แบบ native ของ PDFium

การทำงานนี้คงชื่อ mark, ลำดับ mark, native handle และคุณสมบัติอื่นที่ไม่เกี่ยวข้องทุกรายการไว้

Index และ MarkIndex เป็นแบบ zero-based และอ้างถึงหน้าปัจจุบัน

Parameter values

ตั้ง Param.Key แล้วเลือก pmpInt, pmpFloat, pmpString หรือ pmpBlob ใน Param.Kind

จะมีการอ่านเฉพาะฟิลด์ค่าที่ตรงชนิดเท่านั้น (IntValue, FloatValue, StringValue หรือ BlobValue)

Key เป็น PDF name และต้องเป็นสตริงที่ไม่ว่างเปล่าและเข้ากันได้ระดับไบต์ ส่วนค่า blob ต้องมีอย่างน้อยหนึ่งไบต์

Key ที่มีอยู่แล้วจะถูกแทนที่แม้ชนิดค่าจะเปลี่ยนไป

Removing a parameter

procedure RemovePageObjectMarkParam(Index, MarkIndex: Integer; const Key: WString);

ลบเฉพาะคุณสมบัติที่ระบุชื่อ และคงรายการ marked-content เดิมไว้

Key ที่หาไม่เจอจะ raise EPdfError เพราะไม่มีการเปลี่ยนแปลงใดเกิดขึ้น

Adding or removing a mark

AddPageObjectMark สร้าง mark ใหม่พร้อมอาร์เรย์คุณสมบัติแบบมีชนิดเริ่มต้น และคืนดัชนีของมัน

RemovePageObjectMark ลบรายการ marked-content ทั้งรายการ

ถ้าการตรวจพารามิเตอร์เริ่มต้นล้มเหลว mark ที่เพิ่งสร้างจะถูก rollback

Persistence and performance

การเปลี่ยนแปลงที่สำเร็จแต่ละครั้งจะลบ cache ของ text-page และสร้างเนื้อหาหน้าปัจจุบันใหม่หนึ่งครั้ง เพื่อให้การบันทึกครั้งต่อไปมีรายการคุณสมบัติ BDC ที่อัปเดตแล้ว

อ่าน PageObjectMarks ได้ทันทีเพื่อได้สแนปชอตใหม่ล่าสุด

ค่า PDF number ที่ไม่ใช่จำนวนเต็มจะถูกคืนเป็น pmpFloat

See Also

Advanced page content APIs, GenerateTaggedLayout, StructureElements