QPdfView Class
PDF 뷰어 위젯. 더 보기...
| Header: | #include <QPdfView> |
| Inherits: | QAbstractScrollArea |
공개 유형
속성
|
|
공용 기능
| QPdfView(QWidget *parent) | |
| virtual | ~QPdfView() |
| int | currentSearchResultIndex() const |
| QPdfDocument * | document() const |
| QMargins | documentMargins() const |
| QPdfView::PageMode | pageMode() const |
| QPdfPageNavigator * | pageNavigator() const |
| int | pageSpacing() const |
| QPdfSearchModel * | searchModel() const |
| void | setDocument(QPdfDocument *document) |
| void | setDocumentMargins(QMargins margins) |
| void | setPageSpacing(int spacing) |
| void | setSearchModel(QPdfSearchModel *searchModel) |
| qreal | zoomFactor() const |
| QPdfView::ZoomMode | zoomMode() const |
공용 슬롯
| void | setCurrentSearchResultIndex(int currentResult) |
| void | setPageMode(QPdfView::PageMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPdfView::ZoomMode mode) |
신호
| void | currentSearchResultIndexChanged(int currentResult) |
| void | documentChanged(QPdfDocument *document) |
| void | documentMarginsChanged(QMargins documentMargins) |
| void | pageModeChanged(QPdfView::PageMode pageMode) |
| void | pageSpacingChanged(int pageSpacing) |
| void | searchModelChanged(QPdfSearchModel *searchModel) |
| void | zoomFactorChanged(qreal zoomFactor) |
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
상세 설명
QPdfView는 일반적인 PDF 뷰어 애플리케이션과 유사한 사용자 경험을 제공하는 PDF 뷰어 위젯으로, 두 개의 modes. MultiPage 모드에서는 페이지 이미지 사이의 간격을 좁혀 전체 문서의 페이지를 넘기는 기능을 지원합니다. SinglePage 모드에서는 한 번에 한 페이지씩 표시됩니다.
회원 유형 문서
enum class QPdfView::PageMode
이 열거형은 PDF 뷰어의 전반적인 동작을 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QPdfView::PageMode::SinglePage | 0 | 한 번에 한 페이지씩 표시합니다. |
QPdfView::PageMode::MultiPage | 1 | 문서의 모든 페이지를 스크롤할 수 있도록 허용합니다. |
enum class QPdfView::ZoomMode
이 열거형은 PDF 뷰어의 확대 동작을 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QPdfView::ZoomMode::Custom | 0 | zoomFactor 만 사용하십시오. |
QPdfView::ZoomMode::FitToWidth | 1 | 페이지 너비가 뷰에 맞도록 확대/축소 배율을 자동으로 선택합니다. |
QPdfView::ZoomMode::FitInView | 2 | 전체 페이지가 뷰에 맞도록 확대/축소 배율을 자동으로 선택합니다. |
속성 문서
[since 6.6] currentSearchResultIndex : int
이 속성이 양수로 설정되어 있고 searchModel 가 설정되어 있으면 QPdfView 은 지정된 인덱스에서 QPdfSearchModel 에서 제공하는 검색 결과 주위에 프레임을 그립니다. 예를 들어 QPdfSearchModel 이 QListView 의 모델로 사용되는 경우 QItemSelectionModel::currentChanged()를 QListView::selectionModel()에서 이 함수를 차례로 호출하는 함수에 연결하여 이 속성을 계속 업데이트할 수 있습니다.
기본값은 -1 이므로 검색 결과가 프레이밍되지 않습니다.
이 프로퍼티는 Qt 6.6에 도입되었습니다.
액세스 함수:
| int | currentSearchResultIndex() const |
| void | setCurrentSearchResultIndex(int currentResult) |
알림 신호:
| void | currentSearchResultIndexChanged(int currentResult) |
document : QPdfDocument*
이 속성에는 볼 문서가 저장됩니다.
액세스 함수:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
알림 신호:
| void | documentChanged(QPdfDocument *document) |
documentMargins : QMargins
이 속성은 페이지 보기 주위의 여백을 유지합니다.
액세스 함수:
| QMargins | documentMargins() const |
| void | setDocumentMargins(QMargins margins) |
알림 신호:
| void | documentMarginsChanged(QMargins documentMargins) |
pageMode : PageMode
이 속성에는 한 번에 한 페이지씩 표시할지, 아니면 문서의 모든 페이지를 표시할지가 저장됩니다. 기본값은 SinglePage 입니다.
액세스 기능:
| QPdfView::PageMode | pageMode() const |
| void | setPageMode(QPdfView::PageMode mode) |
알림 신호:
| void | pageModeChanged(QPdfView::PageMode pageMode) |
pageSpacing : int
이 속성은 MultiPage mode 에서 페이지 사이의 패딩 크기를 유지합니다.
액세스 함수:
| int | pageSpacing() const |
| void | setPageSpacing(int spacing) |
알림 신호:
| void | pageSpacingChanged(int pageSpacing) |
[since 6.6] searchModel : QPdfSearchModel*
이 속성을 설정하면 QPdfSearchModel::resultsOnPage()에서 제공하는 검색 결과 위에 QPdfView 하이라이트 사각형을 그립니다. 기본값은 nullptr 입니다.
이 프로퍼티는 Qt 6.6에 도입되었습니다.
액세스 함수:
| QPdfSearchModel * | searchModel() const |
| void | setSearchModel(QPdfSearchModel *searchModel) |
알림 신호:
| void | searchModelChanged(QPdfSearchModel *searchModel) |
zoomFactor : qreal
이 속성은 픽셀과 포인트의 비율을 보유합니다. 기본값은 1 으로, 1포인트(1/72인치)는 1논리 픽셀과 같습니다.
기능에 액세스합니다:
| qreal | zoomFactor() const |
| void | setZoomFactor(qreal factor) |
알림 신호:
| void | zoomFactorChanged(qreal zoomFactor) |
zoomMode : ZoomMode
이 속성은 페이지에 사용자 지정 크기를 사용할지, 아니면 뷰에 맞게 확대/축소할지를 나타냅니다. 기본값은 CustomZoom 입니다.
기능에 액세스합니다:
| QPdfView::ZoomMode | zoomMode() const |
| void | setZoomMode(QPdfView::ZoomMode mode) |
알림 신호:
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
멤버 함수 문서
[explicit] QPdfView::QPdfView(QWidget *parent)
부모 위젯을 사용하여 PDF 뷰어를 구축합니다 parent.
[virtual noexcept] QPdfView::~QPdfView()
PDF 뷰어를 삭제합니다.
QPdfPageNavigator *QPdfView::pageNavigator() const
이 접근자는 뒤로/앞으로 탐색을 처리할 탐색 스택을 반환합니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
