탐색 및 작업
탐색 및 작업
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)을 사용하십시오.
- 문서 간 링크의 경우 PDF 파일을 가리키는 URI 동작 대신
GoToRemoteAction를 사용하십시오. - 페이지의 액션 컬렉션을 사용하면 페이지 열림 시 실행되는 여러 동작을 추가할 수 있습니다.
일반적인 문제
| Issue | Cause | Fix |
|---|---|---|
| 북마크가 이동하지 않음 | 개요 항목에 동작이 설정되지 않음 | GoToAction을 OutlineItemCollection.Action에 할당 |
| GoTo 동작이 잘못된 페이지를 대상으로 함 | 페이지 인덱스는 내부적으로 0부터 시작하지만 페이지는 1부터 시작합니다 | GoToAction 생성자에 doc.Pages[n]을 직접 사용 |
| 명명된 동작이 효과가 없음 | 뷰어가 명명된 동작을 지원하지 않음 | 표준 이름만 사용 |
자주 묻는 질문
목차를 어떻게 만들 수 있나요?
각 섹션마다 OutlineItemCollection 항목을 만들고, 각 항목에GoToAction을 사용하여 섹션의 첫 페이지를 대상으로 합니다.
북마크를 중첩할 수 있나요?
예. 부모 북마크에 자식 OutlineItemCollection 항목을 추가하여 계층형 개요를 만듭니다.
GoTo 동작에 사용할 수 있는 맞춤 유형은 무엇입니까?
Fit, FitH (너비 맞춤), FitV (높이 맞춤), FitR (사각형 맞춤), 및 FitB (경계 상자 맞춤).
API 참조 요약
| Class / Method | Description |
|---|---|
OutlineCollection | 문서의 최상위 북마크 컬렉션 |
OutlineItemCollection | 제목과 동작이 있는 단일 북마크 항목 |
GoToAction | 동일 문서 내 페이지로 이동 |
GoToRemoteAction | 외부 PDF의 페이지로 이동 |
LaunchAction | 외부 파일 열기 |
NamedAction | 미리 정의된 뷰어 명령 트리거 |
PdfAction.CreateGoTo | GoTo 동작을 위한 팩토리 |
PdfAction.CreateNamed | 명명된 동작을 위한 팩토리 |
ActionCollection | 페이지 또는 주석에 대한 동작 컬렉션 |
DestinationCollection | 명명된 목적지 레지스트리 |
ActionType | 열거형: GoTo, URI, JavaScript, Named, Launch |