PDFium Delphi Component Docs

WebLinkCount الخاصية

Component: TPdf  ·  Unit: PDFium
عدد عناوين الويب المكتشفة تلقائيًا عبر مسح نص الصفحة

Syntax

property WebLinkCount[PageNumber: Integer]: Integer; // read only

Description

يُبلغ WebLinkCount عن عدد أنماط URL التي اكتشفها PDFium على الصفحة المحددة بواسطة المعامل PageNumber الذي يبدأ من 1 عبر مسح صفحة النص المعروضة. على عكس LinkAnnotationCount — الذي يعدّ تعليقات /Link الصريحة التي يصرّح بها مؤلف PDF — فإن WebLinkCount يكشف عن عناوين URL التي تظهر كنص عادي (مثل https://example.com) لكنها لم تُغلَّف في تعليق قابل للنقر. يستخدم PDFium مطابقة الأنماط (FPDFLink_LoadWebLinks على FPDF_TEXTPAGE) لاكتشاف http وhttps وmailto: وعدد قليل من أنظمة URI الشائعة الأخرى

تكون القيمة 0 عندما يكون Active بقيمة False أو عندما لا يُعثر على نمط URL. مرّر PageNumber في النطاق 1 .. PageCount. يقود WebLinkCount طبقة الاكتشاف التلقائي التي يستخدمها TPdfView.OnWebLinkClick والخيار loAutoOpenURI — ويعتمد كلاهما على نتائج المسح نفسها

استخدم WebLink[PageNumber, Index] لاسترداد سجل TWebLink (سلسلة URL بالإضافة إلى مصفوفة من الصناديق المحيطة TPdfRectangle، واحد لكل سطر بما أن عنوان URL واحد قد يلتف). تُخزَّن عمليات المسح مؤقتًا لكل صفحة حتى تُعاد تحميل الصفحة، لذا فإن قراءات WebLinkCount المتكررة رخيصة؛ وتنفّذ القراءة الأولى لصفحة معينة المسح الفعلي

Remarks

Example

var P, I: Integer;
var Link: TWebLink;
for P := 1 to Pdf1.PageCount do
  for I := 0 to Pdf1.WebLinkCount[P] - 1 do
  begin
    Link := Pdf1.WebLink[P, I];
    Memo1.Lines.Add(Link.Url);
  end;

See Also

WebLink, LinkAnnotationCount, TPdfView.OnWebLinkClick, TPdfView.LinkOptions