Qt PDF

Qt PDF 모듈에는 PDF 문서 렌더링을 위한 클래스와 함수가 포함되어 있습니다. QPdfDocument 클래스는 PDF 문서를 로드하고 QPdfDocumentRenderOptions 클래스에서 제공하는 옵션에 따라 페이지를 렌더링합니다. QPdfPageRenderer 클래스는 모든 렌더링 요청을 수집하는 대기열을 관리합니다. QPdfPageNavigator 클래스는 PDF 문서 탐색을 처리합니다. QPdfSearchModel 클래스는 문자열을 검색하고 검색 결과를 보관합니다. QPdfBookmarkModel 클래스는 목차가 있는 경우 목차를 보유합니다. QPdfLinkModel 클래스는 페이지의 하이퍼링크에 대한 정보를 보유합니다. QPdfView 위젯은 완전한 PDF 뷰어이며, PDF 뷰어 위젯 예제에서는 사용 방법을 보여줍니다.

Qt Quick 애플리케이션의 경우 세 가지 종류의 완전한 기능을 갖춘 뷰어 구성 요소가 제공됩니다. PdfMultiPageView 은 가장 일반적인 사용자 경험인 전체 문서의 페이지를 넘기는 것을 가장 먼저 선택해야 합니다. PdfScrollablePageView 은 스크롤을 통해 한 번에 한 페이지씩 표시하고, PdfPageView 은 스크롤 없이 한 번에 한 페이지씩 전체 페이지를 표시합니다.

모든 기능을 갖춘 뷰어 구성 요소는 보다 사용자 정의된 PDF 보기 애플리케이션을 작성해야 하는 경우 별도로 사용할 수 있는 하위 수준의 QML 구성 요소로 구성되어 있습니다: PdfDocument, PdfPageImage, PdfPageNavigator, PdfSelection, PdfSearchModel, PdfLinkModel, PdfBookmarkModel 입니다.

텍스트 선택, 검색, 탐색 등의 기능 없이 페이지 이미지만 렌더링해야 하는 경우, 이 모듈에는 PDF를 SVG와 유사한 확장 가능한 이미지 형식으로 처리하는 QImageIOHandler 플러그인이 포함되어 있습니다. 이미지를 사용하고 currentFrame 속성을 표시하려는 페이지 색인으로 설정하기만 하면 됩니다. PDF 파일이 자체 배경을 렌더링하지 않는 경우 이미지의 배경은 투명합니다.

모듈 사용

Qt 모듈을 사용하려면 직접 또는 다른 종속성을 통해 모듈 라이브러리에 연결해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 지원합니다.

CMake로 빌드하기

find_package() 명령을 사용하여 Qt6 패키지에서 필요한 모듈 컴포넌트를 찾습니다:

find_package(Qt6 REQUIRED COMPONENTS Pdf)
target_link_libraries(mytarget Qt6::Pdf)

CMake로 빌드 개요도 참조하세요.

qmake로 빌드하기

모듈에 대해 링크하려면 qmake 프로젝트 파일에 이 줄을 추가합니다:

QT += pdf

예제

• Qt PDF 예제

API 참조

• Qt PDF C++ Classes
• Qt Quick PDF QML Types

문서 및 가이드

• {Qt PDF 플랫폼 노트} {플랫폼 노트}

라이선스 및 저작자 표시

Qt PDF 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한 GNU 약소 일반 공중 사용 허가서 버전 3 또는 GNU 일반 공중 사용 허가서 버전 2에 따라 사용할 수 있습니다. 이 모듈에 대한 자세한 내용은 Qt PDF 라이센스를 참조하십시오.