Класс QPrintPreviewWidget

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

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

Типы публичного интерфейса

Публичные функции

Переопределённые публичные функции

• 211 public functions inherited from QWidget
• 31 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Публичные слоты

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject

Сигналы

• 3 signals inherited from QWidget
• 2 signals inherited from QObject

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

• 58 properties inherited from QWidget
• 1 property inherited from QObject
• 5 static public members inherited from QWidget
• 11 static public members inherited from QObject
• 35 protected functions inherited from QWidget
• 9 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from 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

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

Перечисление QPrintPreviewWidget::ZoomMode

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

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

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

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

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

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

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

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

QPrintPreviewWidget::~QPrintPreviewWidget()

Удаляет виджет QPrintPreviewWidget.

int QPrintPreviewWidget::currentPage() const

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

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

void QPrintPreviewWidget::fitInView()

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

void QPrintPreviewWidget::fitToWidth()

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

QPrinter::Orientation QPrintPreviewWidget::orientation() const

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

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

int QPrintPreviewWidget::pageCount() const

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

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

void QPrintPreviewWidget::paintRequested(QPrinter *printer)

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

void QPrintPreviewWidget::previewChanged()

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

void QPrintPreviewWidget::print()

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

void QPrintPreviewWidget::setAllPagesViewMode()

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

void QPrintPreviewWidget::setCurrentPage(int page)

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

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

void QPrintPreviewWidget::setFacingPagesViewMode()

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

void QPrintPreviewWidget::setLandscapeOrientation()

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

void QPrintPreviewWidget::setOrientation(QPrinter::Orientation orientation)

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

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

void QPrintPreviewWidget::setPortraitOrientation()

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

void QPrintPreviewWidget::setSinglePageViewMode()

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

void QPrintPreviewWidget::setViewMode(ViewMode mode)

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

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

void QPrintPreviewWidget::setVisible(bool visible)

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

void QPrintPreviewWidget::setZoomFactor(qreal factor)

Устанавливает коэффициент масштаба просмотра на factor. Например, значение 1.0 указывает на не масштабируемый просмотр, приблизительно соответствующий размеру просмотра на бумаге. Значение 0.5 уменьшит размер просмотра вдвое, а значение 2.0 увеличит его вдвое.

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

void QPrintPreviewWidget::setZoomMode(ZoomMode zoomMode)

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

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

void QPrintPreviewWidget::updatePreview()

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

ViewMode QPrintPreviewWidget::viewMode() const

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

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

qreal QPrintPreviewWidget::zoomFactor() const

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

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

void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)

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

ZoomMode QPrintPreviewWidget::zoomMode() const

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

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

void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)

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