Программирование с использованием gtkmm 3. Печать

• begin_print: Вы должны обрабатывать этот сигнал, так как на данном этапе вы должны создать и настроить набор объектов областей вывода текста на основе класса Pango::Layout с помощью передаваемого объекта контекста печати на основе класса Gtk::PrintContext, а также разделить ваш печатаемый документ на страницы.
• paginate: Операция разделения документа на страницы может выполняться достаточно медленно, поэтому в том случае, если вы хотите следить за процессом разделения документа на страницы, вы можете осуществить вызов метода Gtk::PrintOperation::set_show_progress() с последующей обработкой данного сигнала.
• Для каждой страницы, изображение которой должно быть сформировано, генерируются следующие сигналы:
  • request_page_setup: Предоставляет объект контекста печати PrintContext, номер страницы и объект настроек страницы на основе класса Gtk::PageSetup. Обрабатывайте этот сигнал в том случае, если вам необходимо модифицировать настройки страниц с доступом к настройками каждой из них.
  • draw_page: вы должны обрабатывать этот сигнал, предоставляющий объект контекста печати PrintContext и номер страницы. Объект контекста печати PrintContext должен использоваться для создания контекста Cairo на основе класса Cairo::Context, с помощью которого обрабатываемая страница должна прорисовываться. Для вывода текста следует осуществить обход набора объектов областей вывода текста на основе класса Pango::Layout, который вы создали в рамках обработчика сигнала "begin_print".
• end_print: Обработчик данного сигнала является безопасным местом для освобождения любых ресурсов, относящихся к представленной объектом на основе класса Gtk::PrintOperation операции печати. В том случае, если вы используете специальный унаследованный от класса Gtk::PrintOperation класс, обычно проще выполнить описанные действия в дестукторе.
• done: Данный сигнал генерируется в момент окончания печати и сообщает о том, что все предназначенные для печати данные были обработаны. Учтите, что передаваемый объект результата печати на основе класса Gtk::PrintOperationResult может сообщать о том, что произошла ошибка. В любом случае, вы, скорее всего, захотите уведомить пользователя о конечном результате операции.
• status_changed: Генерируется всегда, когда изменяется статус задачи печати до ее завершения. Следует вызывать метод Gtk::PrintOperation::set_track_print_status() для отслеживания состояния задачи после начала печати. Для просмотра статуса следует использовать метод get_status() или метод get_status_string().

//В рамках класса, унаследованного от класса Gtk::Window и хранящего объекты m_refPageSetup и m_refSettings в качестве дочерних объектов...
Glib::RefPtr<Gtk::PageSetup> new_page_setup = Gtk::run_page_setup_dialog(*this, m_refPageSetup, m_refSettings);
m_refPageSetup = new_page_setup;

// В рамках метода класса ExampleWindow...
Glib::RefPtr<PrintOperation> op = PrintOperation::create();
// ...настройка объекта операции печати...
op->signal_done().connect(sigc::bind(sigc::mem_fun(*this, &ExampleWindow::on_printoperation_done), op));
// выполнение операции печати

void ExampleWindow::on_printoperation_done(Gtk::PrintOperationResult result, const Glib::RefPtr<PrintOperation>& op)
{
  if (result == Gtk::PRINT_OPERATION_RESULT_ERROR)
    //вывод уведомления для пользователя
  else if (result == Gtk::PRINT_OPERATION_RESULT_APPLY)
    //Обновление параметров объекта настроек печати PrintSettings с использованием параметров объекта операции печати PrintOperation.

  if (! op->is_finished())
    op->signal_status_changed().connect(sigc::bind(sigc::mem_fun(*this, &ExampleWindow::on_printoperation_status_changed), op));
}

void ExampleWindow::on_printoperation_status_changed(const Glib::RefPtr<PrintFormOperation>& op)
{
  if (op->is_finished())
    //операция печати завершена
  else
    //получение статуса операции с помощью метода get_status() или get_status_string()

  //обновление состояния пользовательского интерфейса
}

Glib::RefPtr<Gtk::PrintOperation> op = Gtk::PrintOperation::create();
// ...установка параметров объекта операции печати...
op->set_export_filename("test.pdf");
Gtk::PrintOperationResult res = op->run(Gtk::PRINT_OPERATION_ACTION_EXPORT);

• После установки заголовка вкладки с помощью метода Gtk::PrintOperation::set_custom_tab_label() следует создать новый виджет и вернуть соответствующий ему объект из обработчика сигнала "create_custom_widget". Скорее всего, вы захотите сделать этот виджет контейнерным для упаковки каких-либо других виджетов.
• После работы с диалогом следует получать данные от созданных виджетов с помощью обработчика сигналов "custom_widget_apply".

Gtk::Widget* CustomPrintOperation::on_create_custom_widget()
{
  set_custom_tab_label("Моя специальная вкладка");

  Gtk::Box* hbox = new Gtk::Box(Gtk::ORIENTATION_HORIZONTAL, 8);
  hbox->set_border_width(6);

  Gtk::Label* label = Gtk::manage(new Gtk::Label("Введите какой-либо текст: "));
  hbox->pack_start(*label, false, false);
  label->show();

  hbox->pack_start(m_Entry, false, false);
  m_Entry.show();

  return hbox;
}

void CustomPrintOperation::on_custom_widget_apply(Gtk::Widget* /* widget */)
{
  Glib::ustring user_input = m_Entry.get_text();
  //...
}

// в рамках класса, унаследованного от класса Gtk::Window...
Glib::RefPtr<PrintOperation> op = PrintOperation::create();
// ...настройка параметров объекта операции печати...
op->run(Gtk::PRINT_OPERATION_ACTION_PREVIEW, *this);