ApplyContentFilterChainExt

جریان‌های محتوا

توضیحات

یک زنجیرهٔ مرتب‌شدهٔ پالایه در سطح دستور را روی هر لایهٔ محتوای یک صفحه اجرا می‌کند

نحو

Delphi

Function ApplyContentFilterChainExt(TargetPage: Integer; Const Filters: TPDFContentFilterChain): Integer;

مقادیر بازگشتی

0هیچ لایهٔ محتوایی بازنویسی نشد
Nشمار لایه‌های تجزیه‌شده‌ای که زنجیره پذیرفت و بازنویسی شدند

رفتار در صورت شکست

وقتی سندی انتخاب نشده باشد، TargetPage خارج از بازهٔ صفحات با مبنای یک باشد، Filters برابر nil یا خالی باشد، یا همهٔ لایه‌ها خالی باشند، تجزیه نشوند یا توسط فراخوان بازگشتی رد شوند، 0 برمی‌گرداند. اگر لایهٔ بعدی رد شود، لایه‌های نوشته‌شده تغییر یافته باقی می‌مانند

ملاحظات

هر لایهٔ محتوای غیرخالی به یک TPDFContentProgram تجزیه می‌شود. فراخوان‌های بازگشتی به ترتیب ثبت اجرا می‌شوند و می‌توانند آن برنامه را در جا دگرگون کنند. نام لایه‌های ارسالی به فراخوان‌ها L1، L2 و به همین ترتیب است. نتیجهٔ cfrStop از یک فراخوان بازگشتی، فراخوان‌های باقی‌ماندهٔ آن لایه را متوقف می‌کند و از نوشته‌شدن آن لایه جلوگیری می‌کند و سپس پردازش با لایهٔ بعد ادامه می‌یابد. مالکیت Filters نزد فراخوان باقی می‌ماند

مثال

Filters:= PDF.NewContentFilterChain;
try
  Filters.Add(FirstFilter, nil);
  Filters.Add(SecondFilter, UserData);
  ChangedLayers:= PDF.ApplyContentFilterChainExt(1, Filters);
finally
  Filters.Free;
end;

همچنین ببینید

NewContentFilterChain, ApplyContentFilterChain, SetContentStreamFromString