탐색 및 작업

탐색 및 작업

탐색 및 작업

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");

팁 및 모범 사례

  • 문서 섹션 계층 구조를 반영하는 북마크 트리를 구축하여 직관적인 탐색을 제공하십시오.
  • GoToActionFitType를 사용하여 대상 페이지가 표시되는 방식을 제어합니다(폭 맞춤, 페이지 맞춤 등).
  • 명명된 동작은 뷰어에 따라 다르므로 표준 이름(NextPage, PrevPage, FirstPage, LastPage)을 사용하십시오.
  • 문서 간 링크의 경우 PDF 파일을 가리키는 URI 동작 대신 GoToRemoteAction를 사용하십시오.
  • 페이지의 액션 컬렉션을 사용하면 페이지 열림 시 실행되는 여러 동작을 추가할 수 있습니다.

일반적인 문제

IssueCauseFix
북마크가 이동하지 않음개요 항목에 동작이 설정되지 않음GoToActionOutlineItemCollection.Action에 할당
GoTo 동작이 잘못된 페이지를 대상으로 함페이지 인덱스는 내부적으로 0부터 시작하지만 페이지는 1부터 시작합니다GoToAction 생성자에 doc.Pages[n]을 직접 사용
명명된 동작이 효과가 없음뷰어가 명명된 동작을 지원하지 않음표준 이름만 사용

자주 묻는 질문

목차를 어떻게 만들 수 있나요?

각 섹션마다 OutlineItemCollection 항목을 만들고, 각 항목에
GoToAction을 사용하여 섹션의 첫 페이지를 대상으로 합니다.

북마크를 중첩할 수 있나요?

예. 부모 북마크에 자식 OutlineItemCollection 항목을 추가하여 계층형 개요를 만듭니다.

GoTo 동작에 사용할 수 있는 맞춤 유형은 무엇입니까?

Fit, FitH (너비 맞춤), FitV (높이 맞춤), FitR (사각형 맞춤), 및 FitB (경계 상자 맞춤).


API 참조 요약

Class / MethodDescription
OutlineCollection문서의 최상위 북마크 컬렉션
OutlineItemCollection제목과 동작이 있는 단일 북마크 항목
GoToAction동일 문서 내 페이지로 이동
GoToRemoteAction외부 PDF의 페이지로 이동
LaunchAction외부 파일 열기
NamedAction미리 정의된 뷰어 명령 트리거
PdfAction.CreateGoToGoTo 동작을 위한 팩토리
PdfAction.CreateNamed명명된 동작을 위한 팩토리
ActionCollection페이지 또는 주석에 대한 동작 컬렉션
DestinationCollection명명된 목적지 레지스트리
ActionType열거형: GoTo, URI, JavaScript, Named, Launch

또 보기

 한국어