Класс QPrintPreviewWidget

Класс QPrintPreviewWidget предоставляет виджет для предварительного просмотра макета страницы для печати.

Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Типы публичного доступа

Открытые функции

Переопределенные открытые функции

• 216 открытых функций унаследовано от QWidget
• 31 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Открытые слоты

• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject

Сигналы

• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические открытые члены

• 5 статических открытых членов унаследовано от QWidget
• 9 статических открытых членов унаследовано от QObject

Дополнительные унаследованные члены

• 59 свойств унаследовано от QWidget
• 1 свойства унаследовано от QObject
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice
• 1 защищенный слот унаследовано от QWidget

Подробное описание

Класс QPrintPreviewWidget предоставляет виджет для предварительного просмотра макета страницы для печати.

QPrintPreviewDialog использует QPrintPreviewWidget внутри, и назначение QPrintPreviewWidget заключается в возможности встраивать предварительный просмотр в другие виджеты. Это также позволяет создавать вокруг него пользовательский интерфейс, отличающийся от стандартного, предоставляемого QPrintPreviewDialog.

Использование QPrintPreviewWidget простое:

1. Создайте QPrintPreviewWidget

   Создайте QPrintPreviewWidget, передав существующий объект QPrinter, или пусть QPrintPreviewWidget создаст для вас объект QPrinter по умолчанию.

2. Подключите сигнал paintRequested() к слоту.

   Когда виджету необходимо сгенерировать набор страниц предварительного просмотра, будет выпущен сигнал paintRequested() виджета. Подключите слот к этому сигналу и рисуйте на QPrinter, переданном в качестве параметра сигнала. Используйте QPrinter::newPage(), чтобы начать новую страницу в предварительном просмотре.

См. также QPrinter, QPrintDialog, QPageSetupDialog и QPrintPreviewDialog.

Документация по типам членов

перечисление QPrintPreviewWidget::ViewMode

Это перечисление используется для описания режима просмотра виджета предварительного просмотра.

enum QPrintPreviewWidget::ZoomMode

Этот перечисление используется для описания режима масштабирования виджета предварительного просмотра.

Документация по функциям-членам

QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = ...)

Создаёт QPrintPreviewWidget на основе printer и с parent в качестве родительского виджета. Флаги виджета flags передаются конструктору QWidget.

См. также QWidget::setWindowFlags().

QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = ...)

Это перегруженная функция.

Это приведет к созданию внутреннего объекта QPrinter с конструктором по умолчанию в QPrintPreviewWidget, который будет использоваться для генерации предварительного просмотра.

[virtual] QPrintPreviewWidget::~QPrintPreviewWidget()

Уничтожает QPrintPreviewWidget.

int QPrintPreviewWidget::currentPage() const

Возвращает номер текущей страницы в предварительном просмотре.

См. также setCurrentPage().

[slot] void QPrintPreviewWidget::fitInView()

Это вспомогательная функция, эквивалентная вызову setZoomMode(QPrintPreviewWidget::FitInView).

[slot] void QPrintPreviewWidget::fitToWidth()

Это вспомогательная функция, эквивалентная вызову setZoomMode(QPrintPreviewWidget::FitToWidth).

QPrinter::Orientation QPrintPreviewWidget::orientation() const

Возвращает текущую ориентацию предварительного просмотра. Это значение получено из объекта QPrinter, связанного с предварительным просмотром.

См. также setOrientation().

int QPrintPreviewWidget::pageCount() const

Возвращает количество страниц в предварительном просмотре.

Эта функция была добавлена в Qt 4.6.

[signal] void QPrintPreviewWidget::paintRequested(QPrinter *printer)

Этот сигнал испускается, когда виджет предварительного просмотра должен сгенерировать набор страниц предварительного просмотра. printer — принтер, связанный с этим виджетом предварительного просмотра.

[signal] void QPrintPreviewWidget::previewChanged()

Этот сигнал испускается всякий раз, когда виджет предварительного просмотра изменяет какое-либо внутреннее состояние, например, ориентацию.

[slot] void QPrintPreviewWidget::print()

Печатает предварительный просмотр на принтере, связанном с предварительным просмотром.

[slot] void QPrintPreviewWidget::setAllPagesViewMode()

Это вспомогательная функция, эквивалентная вызову setViewMode(QPrintPreviewWidget::AllPagesView).

[slot] void QPrintPreviewWidget::setCurrentPage(int page)

Устанавливает текущую страницу в предварительном просмотре. Это заставит просмотр перейти к началу страницы page.

См. также currentPage().

[slot] void QPrintPreviewWidget::setFacingPagesViewMode()

Это вспомогательная функция, эквивалентная вызову setViewMode(QPrintPreviewWidget::FacingPagesView).

[slot] void QPrintPreviewWidget::setLandscapeOrientation()

Это вспомогательная функция, эквивалентная вызову setOrientation(QPrinter::Landscape).

[slot] void QPrintPreviewWidget::setOrientation(QPrinter::Orientation orientation)

Устанавливает текущую ориентацию на orientation. Это значение будет установлено в объекте QPrinter, связанном с предварительным просмотром.

См. также orientation().

[slot] void QPrintPreviewWidget::setPortraitOrientation()

Это вспомогательная функция, эквивалентная вызову setOrientation(QPrinter::Portrait).

[slot] void QPrintPreviewWidget::setSinglePageViewMode()

Это вспомогательная функция, эквивалентная вызову setViewMode(QPrintPreviewWidget::SinglePageView).

[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)

Устанавливает режим отображения на mode. Режим отображения по умолчанию — SinglePageView.

См. также viewMode().

[override virtual] void QPrintPreviewWidget::setVisible(bool visible)

Переопределено из QWidget::setVisible().

[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)

Устанавливает коэффициент масштаба просмотра на factor. Например, значение 1,0 указывает на отображение без масштабирования, которое примерно соответствует размеру отображения на бумаге. Значение 0,5 уменьшит размер отображения вдвое, а значение 2,0 — увеличит размер отображения вдвое.

См. также zoomFactor().

[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)

Устанавливает режим масштабирования на zoomMode. Режим масштабирования по умолчанию — FitInView.

См. также zoomMode(), viewMode() и setViewMode().

[slot] void QPrintPreviewWidget::updatePreview()

Эта функция обновляет предварительный просмотр, что приводит к вызову сигнала paintRequested().

QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const

Возвращает текущий режим отображения. Режим отображения по умолчанию — SinglePageView.

См. также setViewMode().

qreal QPrintPreviewWidget::zoomFactor() const

Возвращает коэффициент масштабирования отображения.

См. также setZoomFactor().

[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)

Увеличивает текущее отображение на factor. Значение по умолчанию для factor — 1,1, что означает увеличение отображения на 10%.

QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const

Возвращает текущий режим масштабирования.

См. также setZoomMode(), viewMode() и setViewMode().

[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)

Уменьшает текущее отображение на factor. Значение по умолчанию для factor — 1,1, что означает уменьшение отображения на 10%.