PDFium Delphi Component Docs

Destination الخاصية

المكوّن: TPdf  ·  الوحدة: PDFium
يعيد وجهة مسماة مع صفحتها الهدف، ووضع عرض PDF، ومعاملات العرض الخام، والإحداثيات، وعلامات التكبير

الصياغة

property Destination[Index: Integer]: TDestination; // للقراءة فقط

الوصف

الوجهة المسماة هي اسم رمزي (مثلًا "chap5.fig3") مخزَّن في كتالوج مستند PDF يُحل إلى مجموعة صفحة-موضع-تكبير ملموسة. تتيح للمخططات وتعليقات الروابط والمستندات الخارجية الإشارة إلى هدف باسم مستقر بدلًا من إحداثيات صفحة مشفرة بشكل ثابت، بحيث يمكن إعادة ترقيم صفحات المستند دون كسر الروابط الواردة

يبسط PDFium Delphi Component كلاً من قواميس /Dests القديمة وأشجار أسماء /Names /Dests الحديثة إلى قائمة صفرية الأساس واحدة. يعيد Destination[Index] سجل TDestination يحمل اسم الوجهة، والصفحة الهدف ذات الأساس 1، و ViewMode المفكوك، و ViewParameters الخام، وإحداثيات العرض، ومعامل التكبير، وعلامات الوجود

استخدم DestinationCount للحصول على العدد الإجمالي للوجهات المسماة، وكرِّر عبر Destination[I]، واستخدم DestinationByName عندما تعرف اسم الهدف مسبقًا

Parameters

IndexInteger. موضع صفري الأساس في قائمة الوجهات المسماة المبسطة. يجب أن يكون في [0, DestinationCount - 1]. يعيد الفهرس خارج النطاق سجلًا مُصفَّرًا مع Handle = nil.

ملاحظات

مثال

var
  I: Integer;
  Dest: TDestination;
begin
  Pdf1.LoadFromFile('manual.pdf');
  Memo1.Lines.Add(Format('%d named destinations:', [Pdf1.DestinationCount]));
  for I := 0 to Pdf1.DestinationCount - 1 do
  begin
    Dest := Pdf1.Destination[I];
    Memo1.Lines.Add(Format('%s -> page %d (X=%.1f Y=%.1f Zoom=%.2f)',
      [Dest.Name, Dest.PageNumber, Dest.X, Dest.Y, Dest.Zoom]));
  end;
  // Navigate to the first destination
  if Pdf1.DestinationCount > 0 then
    Pdf1.PageNumber := Pdf1.Destination[0].PageNumber;
end;

انظر أيضًا

DestinationCount, DestinationByName, PageNumber, Bookmark, LinkAnnotation