Навигация и дейности
Навигация и дейности
Aspose.PDF FOSS for .NET supports PDF navigation structures — bookmarks (outlines), page destinations, and document actions. These let you create interactive documents with table-of-contents navigation, cross-page links, and JavaScript triggers.
Описание на документа (записвачи)
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");Действия за преминаване към действие
GoToAction навигира към определена страница и се вписва в същата документ.
var goTo = new GoToAction(doc.Pages[3]);Названи действия
NamedAction задейства предварително дефинирани команди на PDF прогледвача като NextPage, Предишната страница, Първата и Последната.
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, PrevPagepage , FirstPages, LastPags).
- За връзки между документи, използвайте:
GoToRemoteActionвместо URI действия, насочващи към PDF файлове. - Сборниците от действия на страница ви позволяват да добавите множество действия, които се задействат при отваряне на страницата.
Общи проблеми
| Издание | Причина за това | Ремонтиране |
|---|---|---|
| Не се навигира с букмарка. | Действие, което не е определено в общата позиция | Присъединяване на: GoToAction в) към OutlineItemCollection.Action |
| Насочване към действие цели грешна страница | Индексът на страниците е базиран на 0 вътрешно, но страници са базирани на 1 | Използване на: doc.Pages[n] директно в конструктора GoToAction |
| Названото действие няма ефект. | Визуалният файл не поддържа посоченото действие. | Използвайте само стандартни имена. |
FAQ
Как да създам таблица с съдържание?
Създаване на OutlineItemCollection вписвания за всеки раздел, всяка с GoToAction Да се насочим към първата страница на секцията.
Мога ли да си запечатам?
Да, добавете дете. OutlineItemCollection вписвания към основен заклад, който трябва да се създаде йерархичен план.
Какви типове съвпадения са налични за действия на GoTo?
Fit, FitH (широчина на фит), FitV (висока височина), fitR (правилен правоъгълник) и FitB (крепост за граничане на фит).
Снимка на API референтна информация
| Клас / метод | Описание на състоянието |
|---|---|
OutlineCollection | Събиране на заглавията от най-високо ниво в документа |
OutlineItemCollection | Единна запис на книжка с заглавие и действие |
GoToAction | Премести към страница в същия документ |
GoToRemoteAction | Преминаване към страница в външен PDF файл |
LaunchAction | Отваряне на външен файл |
NamedAction | Задействане на предварително дефинирана команда за гледане |
PdfAction.CreateGoTo | Фабрика за действия на ГТО |
PdfAction.CreateNamed | Фабрика за наименовани действия |
ActionCollection | Събиране на действия в страница или аннотация |
DestinationCollection | Регистър на посоченото местоназначение |
ActionType | Списък: GoTo, URI, JavaScript, Название, Стартиране |