Lifecycle actions - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

PDF belge ve sayfa yaşam döngüsü eylemlerinin ne zaman yürütüleceğini denetler; açık kaydetme ve yazdırma sınırlarını da kapsar

Types

TPdfLifecycleActionPolicy = (lapDisabled, lapManual, lapAutomatic);

TPdfDocumentLifecycleAction = (dlaJavaScript, dlaOpen, dlaWillClose, dlaWillSave, dlaDidSave, dlaWillPrint, dlaDidPrint);

TPdfPageLifecycleAction = (plaOpen, plaClose);

Execution policy

property LifecycleActionPolicy: TPdfLifecycleActionPolicy; // default lapAutomatic

lapDisabled, otomatik ve açık yaşam döngüsü eylemi yürütmelerinin ikisini de engeller

lapManual otomatik eylemleri bastırırken iki açık yürütme yöntemine izin verir

lapAutomatic, uyumlu otomatik belge JavaScript'i, belge açma/kapatma ve sayfa açma/kapatma davranışını korur ve yine de açık yürütmeye izin verir

Otomatik mod kaydetme veya yazdırma işlemlerini sarmalamaz çünkü dahili anlık görüntüler ve dönüşüm kaydetmeleri beklenmedik biçimde belge betikleri çalıştırmamalıdır; açık belge yöntemini ana makinenin denetlediği iş akışı sınırlarında çağırın

Document actions

function ExecuteDocumentLifecycleAction(Action: TPdfDocumentLifecycleAction; out ErrorMessage: string): Boolean;

dlaJavaScript belge düzeyi JavaScript ad ağacı eylemlerini çalıştırır, dlaOpen katalog açma eylemini çalıştırır

dlaWillClose, dlaWillSave, dlaDidSave, dlaWillPrint ve dlaDidPrint karşılık gelen belge ek eylemini sevk eder

Yöntem; ilke yürütmeyi engellediğinde, form doldurma ortamı kullanılamadığında veya bir geri çağırma istisna fırlattığında boş olmayan bir ErrorMessage ile False döndürür

Page actions

function ExecutePageLifecycleAction(PageNumber: Integer; Action: TPdfPageLifecycleAction; out ErrorMessage: string): Boolean;

PageNumber birden başlar ve etkin belgedeki bir sayfayı tanımlamalıdır

Geçerli sayfa yüklenmiş yerel tutamacını yeniden kullanır; başka bir sayfa geçici olarak açılır, form ortamına kaydedilir, sevk edilir, kaydı silinir ve TPdf.PageNumber değiştirilmeden kapatılır

Yükleme, kayıt, eylem, temizlik ve kapatma başarısızlıkları dönüş değerine ve ErrorMessage alanına yalıtılır

Save workflow example

var
  ErrorMessage: string;
begin
  Pdf.LifecycleActionPolicy := lapManual;
  if not Pdf.ExecuteDocumentLifecycleAction(dlaWillSave, ErrorMessage) then
    raise Exception.Create(ErrorMessage);
  try
    Pdf.SaveAs(TargetFileName);
  finally
    Pdf.ExecuteDocumentLifecycleAction(dlaDidSave, ErrorMessage);
  end;
end;

Security

Yaşam döngüsü eylemleri, TPdf üzerinde yapılandırılmış belge JavaScript'ini, adlandırılmış eylemleri, URI geri çağırmalarını ve diğer ana makine hizmetlerini çağırabilir

Asla eylem çalıştırmaması gereken güvenilmeyen belgeler için lapDisabled, uygulamanın açık bir onay sınırına ihtiyaç duyduğu durumlarda lapManual kullanın

Yaşam döngüsü eylemleri