ניווט ופעולות

ניווט ופעולות

Aspose.PDF FOSS for .NET תומך במבני ניווט של PDF — סימניות (מתווה), יעדי דפים, ופעולות מסמך. אלה מאפשרים לך ליצור מסמכים אינטראקטיביים עם ניווט תוכן עניינים, קישורים בין דפים, והפעלת JavaScript.

מתארי מסמך (סימניות)

OutlineCollection מחזיק בעץ הסימניות של המסמך. כל OutlineItemCollection הוא ערך סימנייה עם כותרת ויעד.

using var doc = Document.Open(pdfBytes);

foreach (var item in doc.Outlines)
{
    Console.WriteLine($"Bookmark: {item.Title}");
}

יצירת סימניות

using var doc = Document.Open(pdfBytes);

var bookmark = new OutlineItemCollection(doc.Outlines);
bookmark.Title = "Chapter 1";
bookmark.Action = new GoToAction(doc.Pages[1]);
doc.Outlines.Add(bookmark);

doc.Save("with-bookmarks.pdf");

פעולות GoTo

GoToAction מנווט לעמוד ספציפי ולסוג התאמה בתוך אותו המסמך.

var goTo = new GoToAction(doc.Pages[3]);

פעולות בשם

NamedAction מפעיל פקודות מוגדרות מראש של מציג PDF כגון NextPage, PrevPage, FirstPage, ו-LastPage.

var nextPage = PdfAction.CreateNamed("NextPage");

פעולות GoToRemote

GoToRemoteAction פותח קובץ PDF חיצוני ומנווט לעמוד ספציפי.

var remote = new GoToRemoteAction("other.pdf", 1);

הפעלת פעולות

LaunchAction פותח קובץ חיצוני (בכל פורמט) מקישור PDF.

var launch = new LaunchAction("readme.txt");

אוספי יעד

DestinationCollection ממפה יעדים בשם לעמודים, תומך בניווט הפניות חוצות במסמכים גדולים.

var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");

טיפים ושיטות מומלצות

• בנה עץ סימניות המשקף את היררכיית הסעיפים של המסמך שלך לניווט אינטואיטיבי.
• השתמש בGoToAction עם FitType כדי לשלוט באופן שבו מוצגת דף היעד (התאמה לרוחב, התאמה לעמוד, וכו’).
• פעולות בשם תלויות במציג — השתמש בשמות סטנדרטיים (NextPage, PrevPage, FirstPage, LastPage).
• לקישורים בין מסמכים, השתמש בGoToRemoteAction במקום פעולות URI שמצביעות על קבצי PDF.
• אוספי פעולות בדף מאפשרים לך להוסיף מספר פעולות שמופעלות בפתיחת הדף.

בעיות נפוצות

שאלות נפוצות

איך ליצור תוכן עניינים?

צור ערכי OutlineItemCollection עבור כל סעיף, כל אחד עם
GoToAction המכוון לדף הראשון של הסעיף.

האם ניתן לקנן סימניות?

כן. הוסף ערכי OutlineItemCollection כילדים לסימנייה הורה כדי ליצור מתאר היררכי.

אילו סוגי התאמה זמינים לפעולות GoTo?

Fit, FitH (התאמה לרוחב), FitV (התאמה לגובה), FitR (התאמה למלבן), ו‑FitB (התאמה לתיבת גבול).

סיכום הפניות ל‑API

ראה גם

• Aspose.PDF for .NET מוצר Enterprise