Поддерживаемые члены Qt 3 класса QPrinter

Описанные ниже члены класса являются частью слоя поддержки Qt 3. Они введены для поддержки старого кода в Qt 4. Мы советуем не использовать их во вновь создаваемом коде.

• Описание класса QPrinter

Открытые типы

enum	PrinterOption { PrintToFile, PrintSelection, PrintPageRange }

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

bool	aborted ()
bool	collateCopiesEnabled () const
bool	isOptionEnabled ( PrinterOption option ) const
void	margins ( uint * top, uint * left, uint * bottom, uint * right ) const
QSize	margins () const
int	maxPage () const
int	minPage () const
bool	outputToFile () const
bool	pageSetup ( QWidget * parent = 0 )
bool	printSetup ( QWidget * parent = 0 )
void	setCollateCopiesEnabled ( bool enable )
void	setMinMax ( int minPage, int maxPage )
void	setOptionEnabled ( PrinterOption option, bool enable )
void	setOutputToFile ( bool enable )
bool	setup ( QWidget * parent = 0 )

• 8 открытых функций, унаследованных от QPaintDevice

Описание типов-членов

enum QPrinter::PrinterOption

Вместо этого используйте QAbstractPrintDialog::PrintDialogOption.

Константа	Значение
QPrinter::PrintToFile	0
QPrinter::PrintSelection	1
QPrinter::PrintPageRange	2

Описание функций-членов

bool QPrinter::aborted ()

Вместо этого используйте printerState() == QPrinter::Aborted.

bool QPrinter::collateCopiesEnabled () const

Возвращает true, если принтер настроен на сортировку копий печатаемых документов; в противном случае возвратит false.

Вместо этого используйте QPrintDialog::isOptionEnabled(QPrintDialog::PrintCollateCopies).

Смотрите также setCollateCopiesEnabled() и collateCopies().

bool QPrinter::isOptionEnabled ( PrinterOption option ) const

Вместо этого используйте QPrintDialog.

void QPrinter::margins ( uint * top, uint * left, uint * bottom, uint * right ) const

Устанавливает *top, *left, *bottom, *right верхним, левым, нижним и правым полями.

Эта функция заменена на paperRect() и pageRect(). Используйте paperRect().top() - pageRect().top() для верхнего поля, paperRect().left() - pageRect().left() для левого поля, paperRect().bottom() - pageRect().bottom() для нижнего поля и papaerRect().right() - pageRect().right() для правого поля.

Например, если у вас есть код

 uint rightMargin;
 uint bottomMargin;
 printer->margins(0, 0, &bottomMargin, &rightMargin);

вы можете записать его в виде

 int rightMargin = printer->paperRect().right() - printer->pageRect().right();
 int bottomMargin = printer->paperRect().bottom() - printer->pageRect().bottom();

QSize QPrinter::margins () const

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

Возвращает QSize, содержащий левое и верхнее поле.

Эта функция заменена на paperRect() и pageRect(). Используйте paperRect().left() - pageRect().left() для левого поля и paperRect().top() - pageRect().top() для верхнего поля.

Например, если у вас есть код

 QSize margins = printer->margins();
 int leftMargin = margins.width();
 int topMargin = margins.height();

вы можете записать его в виде

 int leftMargin = printer->paperRect().left() - printer->pageRect().left();
 int topMargin = printer->paperRect().top() - printer->pageRect().top();

int QPrinter::maxPage () const

Вместо этого используйте QPrintDialog::maxPage().

int QPrinter::minPage () const

Вместо этого используйте QPrintDialog::minPage().

bool QPrinter::outputToFile () const

Возвращает true, если вывод будет записываться в файл, или false, если вывод будет отправлен непосредственно на принтер. Настройкой по умолчанию является false.

Смотрите также setOutputToFile() и setOutputFileName().

bool QPrinter::pageSetup ( QWidget * parent = 0 )

Выполняет диалог настройки печати, так что пользователь может настроить тип страницы, используемой для печати. Возвращает true, если содержимое диалога принято; возвращает false, если диалог отменён.

bool QPrinter::printSetup ( QWidget * parent = 0 )

Выполняет диалог настройки печати, так что пользователь может настроить процесс печати. Возвращает true, если содержимое диалога принято; возвращает false, если диалог отменён.

void QPrinter::setCollateCopiesEnabled ( bool enable )

Вместо этого используйте QPrintDialog::setOption(QPrintDialog::PrintCollateCopies) или QPrintDialog::setOptions(QPrintDialog::options() & ~QPrintDialog::PrintCollateCopies), в зависимости от enable.

Смотрите также collateCopiesEnabled().

void QPrinter::setMinMax ( int minPage, int maxPage )

Вместо этого используйте QPrintDialog::setMinMax().

void QPrinter::setOptionEnabled ( PrinterOption option, bool enable )

Вместо этого используйте QPrintDialog.

Смотрите также isOptionEnabled().

void QPrinter::setOutputToFile ( bool enable )

Определяет, будет ли вывод записываться в файл или отправляться непосредственно на принтер.

Будет выводить в файл, если enable равно true, или же будет выводить непосредственно на принтер, если enable равно false.

Смотрите также outputToFile() и setOutputFileName().

bool QPrinter::setup ( QWidget * parent = 0 )

Вместо этого используйте QPrintDialog.

Например, если у вас есть код

 if (printer->setup(parent))
     ...

вы можете записать его в виде

 QPrintDialog dialog(printer, parent);
 if (dialog.exec())
     ...