คลาส THPDFCancellationToken

ให้สัญญาณยกเลิกแบบใช้ครั้งเดียวที่ thread-safe โดยการทำงานยาวๆ ของ HotPDF จะคอยเช็กสัญญาณนี้ที่จุดแบ่งงานที่คงที่

การประกาศ

THPDFCancellationToken = class(TObject)
public
  procedure Cancel;
  procedure ThrowIfCancellationRequested(
    const OperationName: AnsiString = 'operation');
  property IsCancellationRequested: Boolean read GetIsCancellationRequested;
end;

ยูนิต

HPDFTypes

สมาชิก

หมายเหตุการใช้งาน

• ผู้เรียกเป็นเจ้าของ token และต้องรักษาให้มีชีวิตอยู่ตลอดการทำงานหรือตลอด session การ render แบบ progressive
• Token เรียก Cancel ไปแล้ว reset ไม่ได้ สำหรับงานถัดไปให้สร้าง instance ใหม่
• การยกเลิกเป็นแบบ cooperative ดังนั้น content operator ขั้นบีบอัด หรือการเรียก private key ของระบบปฏิบัติการในตอนนั้นอาจทำจนจบก่อนที่คำขอจะถูกมองเห็น
• EHPDFOperationCancelled.OperationName ระบุ operation ที่เป็นฝ่ายเจอคำขอยกเลิก

API ที่เกี่ยวข้อง

• THotPDF.OperationCancellationToken
• THPDFLoadedPageRenderSession
• การเรนเดอร์แบบค่อยเป็นค่อยไปและการยกเลิก