Наши партнеры

Библиотека сайта rus-linux.net

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

Оригинал: Programming with gtkmm 3
Авторы: Murray Cumming, Bernhard Rieder, Jonathon Jongsma, Ole Laursen, Marko Anastasov, Daniel Elstner, Chris Vine, David King, Pedro Ferreira, Kjell Ahlstedt
Перевод: А.Панин

20.8. Пример

20.8.1. Простой пример

Следующий пример демонстрирует методику печати введенных с помощью пользовательского интерфейса данных. Он показывает способ реализации обработчиков сигналов "on_begin_print" и "on_draw_page", а также способ вывода статуса печати и обновления параметров печати.

Рисунок 20-1: Печать - Простой пример

Исходный код

Файл: examplewindow.h (Для использования совместно с gtkmm 3, а не с gtkmm 2)

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

class PrintFormOperation;

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:

void build_main_menu();

void print_or_preview(Gtk::PrintOperationAction print_action);

//Обработчики сигналов объекта операции печати PrintOperation.
  //Благодаря их использованию мы можем получить необходимую информацию для обновления состояния пользовательского интерфейса или настроек печати.
  //В рамках нашего унаследованного от класса Gtk::PrintOperation класса также осуществляется перекрытие некоторых обработчиков сигналов.
  void on_printoperation_status_changed(const Glib::RefPtr<PrintFormOperation>& operation);

void on_printoperation_done(Gtk::PrintOperationResult result, const Glib::RefPtr<PrintFormOperation>& operation);

//Обработчики сигналов, соответствующих действиям:
  void on_menu_file_new();
  void on_menu_file_page_setup();
  void on_menu_file_print_preview();
  void on_menu_file_print();
  void on_menu_file_quit();

//Объекты, относящиеся к печати:
  Glib::RefPtr<Gtk::PageSetup> m_refPageSetup;
  Glib::RefPtr<Gtk::PrintSettings> m_refSettings;

//Дочерние виджеты:
  Gtk::Box m_VBox;
  Gtk::Grid m_Grid;

Gtk::Label m_NameLabel;
  Gtk::Entry m_NameEntry;

Gtk::Label m_SurnameLabel;
  Gtk::Entry m_SurnameEntry;

Gtk::Label m_CommentsLabel;
  Gtk::ScrolledWindow m_ScrolledWindow;
  Gtk::TextView m_TextView;
  
  Glib::RefPtr<Gtk::TextBuffer> m_refTextBuffer;

unsigned m_ContextId;
  Gtk::Statusbar m_Statusbar;

Glib::RefPtr<Gtk::Builder> m_refBuilder;
};

#endif //GTKMM_EXAMPLEWINDOW_H

Файл: printformoperation.h (Для использования совместно с gtkmm 3, а не с gtkmm 2)

#ifndef GTKMM_PRINT_FORM_OPERATION_H
#define GTKMM_PRINT_FORM_OPERATION_H

#include <gtkmm.h>
#include <pangomm.h>
#include <vector>

//Мы наследуем свой собственный класс от класса операции печати Gtk::PrintOperation,
//поэтому мы можем размещать реализации функций печати в рамках данного класса.
class PrintFormOperation : public Gtk::PrintOperation
{
 public:
  static Glib::RefPtr<PrintFormOperation> create();
  virtual ~PrintFormOperation();

void set_name(const Glib::ustring& name) { m_Name = name; }
  void set_comments(const Glib::ustring& comments) { m_Comments = comments; }

protected:
  PrintFormOperation();

//Перекрытие стандартных обработчиков сигналов класса операции печати Gtk::PrintOperation:
  virtual void on_begin_print(const Glib::RefPtr<Gtk::PrintContext>& context);
  virtual void on_draw_page(const Glib::RefPtr<Gtk::PrintContext>& context, int page_nr);

Glib::ustring m_Name;
  Glib::ustring m_Comments;
  Glib::RefPtr<Pango::Layout> m_refLayout;
  std::vector<int> m_PageBreaks; // номера строк, соответствующих разрывам страниц
};

#endif // GTKMM_PRINT_FORM_OPERATION_H

Файл: printformoperation.cc (Для использования совместно с gtkmm 3, а не с gtkmm 2)

#include "printformoperation.h"

PrintFormOperation::PrintFormOperation()
{
}

PrintFormOperation::~PrintFormOperation()
{
}

Glib::RefPtr<PrintFormOperation> PrintFormOperation::create()
{
  return Glib::RefPtr<PrintFormOperation>(new PrintFormOperation());
}

void PrintFormOperation::on_begin_print(
        const Glib::RefPtr<Gtk::PrintContext>& print_context)
{
  //Создание и настройка системы вывода текста библиотеки Pango для объекта данных 
  //печати PrintData на основе переданного объекта контекста печати PrintContext: 
  //Впоследствии мы используем его для расчета необходимого количества страниц и распределения строк по каждой из страниц.
  m_refLayout = print_context->create_pango_layout();

Pango::FontDescription font_desc("sans 12");
  m_refLayout->set_font_description(font_desc);

const double width = print_context->get_width();
  const double height = print_context->get_height();

m_refLayout->set_width(static_cast<int>(width * Pango::SCALE));

//Формирование текста с разметкой для печати:
  Glib::ustring marked_up_form_text;
  marked_up_form_text += "<b>Имя</b>: " + m_Name + "\n\n";
  marked_up_form_text += "<b>Комментарии</b>: " + m_Comments;

m_refLayout->set_markup(marked_up_form_text);

//Установка количества страниц для печати на основе вычисленного количества строк,
  //на которых происходят разрывы страниц:
  const int line_count = m_refLayout->get_line_count();

Glib::RefPtr<Pango::LayoutLine> layout_line;
  double page_height = 0;

for (int line = 0; line < line_count; ++line)
  {
    Pango::Rectangle ink_rect, logical_rect;

layout_line = m_refLayout->get_line(line);
    layout_line->get_extents(ink_rect, logical_rect);

const double line_height = logical_rect.get_height() / 1024.0;

if (page_height + line_height > height)
    {
      m_PageBreaks.push_back(line);
      page_height = 0;
    }

page_height += line_height;
  }

set_n_pages(m_PageBreaks.size() + 1);
}

void PrintFormOperation::on_draw_page(
        const Glib::RefPtr<Gtk::PrintContext>& print_context, int page_nr)
{
  //Выявление того, какие строки следует напечатать для завершения печати заданной страницы:
  int start_page_line = 0;
  int end_page_line = 0;

if(page_nr == 0)
  {
    start_page_line = 0;
  }
  else
  {
    start_page_line = m_PageBreaks[page_nr - 1];
  }

if(page_nr < static_cast<int>(m_PageBreaks.size()))
  {
    end_page_line = m_PageBreaks[page_nr];
  }
  else
  {
    end_page_line = m_refLayout->get_line_count();
  }

//Получение объекта контекста Cairo, который будет использоваться как область для рисования:
  Cairo::RefPtr<Cairo::Context> cairo_ctx = print_context->get_cairo_context();

//Мы будем использовать буквы черного цвета:
  cairo_ctx->set_source_rgb(0, 0, 0);

//Вывод строк Pango (LayoutLines) с помощью контекста Cairo:
  Pango::LayoutIter iter = m_refLayout->get_iter();

double start_pos = 0;
  int line_index = 0;

do
  {
    if(line_index >= start_page_line)
    {
      Glib::RefPtr<Pango::LayoutLine> layout_line = iter.get_line();
      Pango::Rectangle logical_rect = iter.get_line_logical_extents();
      int baseline = iter.get_baseline();

if (line_index == start_page_line)
      {
        start_pos = logical_rect.get_y() / 1024.0;
      }

cairo_ctx->move_to(logical_rect.get_x() / 1024.0,
        baseline / 1024.0 - start_pos);

layout_line->show_in_cairo_context(cairo_ctx);
    }

line_index++;
  }
  while(line_index < end_page_line && iter.next_line());
}

Файл: examplewindow.cc (Для использования совместно с gtkmm 3, а не с gtkmm 2)

#include "examplewindow.h"
#include "printformoperation.h"

#include <iostream>

#include <pangomm.h>

const Glib::ustring app_title = "Пример печати с использованием gtkmm";

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_NameLabel("Имя"),
  m_SurnameLabel("Фамилия"),
  m_CommentsLabel("Комментарии")
{
  m_refPageSetup = Gtk::PageSetup::create();
  m_refSettings = Gtk::PrintSettings::create();

m_ContextId = m_Statusbar.get_context_id(app_title);

set_title(app_title);
  set_default_size(400, 300);

add(m_VBox);

build_main_menu();

m_VBox.pack_start(m_Grid);

//Распределение виджетов в сетке:
  m_Grid.set_row_spacing(5);
  m_Grid.set_column_spacing(5);
  m_Grid.attach(m_NameLabel, 0, 0, 1, 1);
  m_Grid.attach(m_NameEntry, 1, 0, 1, 1);

m_Grid.attach(m_SurnameLabel, 0, 1, 1, 1);
  m_Grid.attach(m_SurnameEntry, 1, 1, 1, 1);

//Добавление виджета поля ввода текста TextView, в окно прокрутки ScrolledWindow:
  m_ScrolledWindow.add(m_TextView);

//Показ полос прокрутки только в случае необходимости:
  m_ScrolledWindow.set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);

m_Grid.attach(m_CommentsLabel, 0, 2, 1, 1);
  m_Grid.attach(m_ScrolledWindow, 1, 2, 1, 1);
  m_ScrolledWindow.set_hexpand(true);
  m_ScrolledWindow.set_vexpand(true);

m_refTextBuffer = Gtk::TextBuffer::create();
  m_TextView.set_buffer(m_refTextBuffer);

m_VBox.pack_start(m_Statusbar);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::build_main_menu()
{
  //Создание действий для меню и панелей инструментов:
  Glib::RefPtr<Gio::SimpleActionGroup> refActionGroup =
   Gio::SimpleActionGroup::create();

//Меню "Файл":
  refActionGroup->add_action("new",
    sigc::mem_fun(*this, &ExampleWindow::on_menu_file_new));

refActionGroup->add_action("pagesetup",
    sigc::mem_fun(*this, &ExampleWindow::on_menu_file_page_setup));

refActionGroup->add_action("printpreview",
    sigc::mem_fun(*this, &ExampleWindow::on_menu_file_print_preview));

refActionGroup->add_action("print",
    sigc::mem_fun(*this, &ExampleWindow::on_menu_file_print));

refActionGroup->add_action("quit",
    sigc::mem_fun(*this, &ExampleWindow::on_menu_file_quit));

insert_action_group("example", refActionGroup);

m_refBuilder = Gtk::Builder::create();
 
  //TODO: add_accel_group(m_refBuilder->get_accel_group());

//Строковое представление действий для меню и панели инструментов:
  
  Glib::ustring ui_info = 
   "<interface>"
    "  <menu id='menu-example'>"
    "    <submenu>"
    "      <attribute name='label' translatable='yes'>_Файл</attribute>"
    "      <section>"
    "        <item>"
    "          <attribute name='label' translatable='yes'>Настройка _страницы</attribute>"
    "          <attribute name='action'>example.pagesetup</attribute>"
    "        </item>"
    "        <item>"
    "          <attribute name='label' translatable='yes'>Предварительный просмотр</attribute>"
    "          <attribute name='action'>example.printpreview</attribute>"
    "        </item>"
    "        <item>"
    "          <attribute name='label' translatable='yes'>_Печать</attribute>"
    "          <attribute name='action'>example.print</attribute>"
    "        </item>"
    "      </section>"
    "    </submenu>"
    "  </menu>"
/* TODO:
      "  <toolbar  name='ToolBar'>"
        "    <toolitem action='New'/>"
        "    <toolitem action='Print'/>"
        "      <separator/>"
        "    <toolitem action='Quit'/>"
        "  </toolbar>"
*/
    "</interface>";

try
  {      
    m_refBuilder->add_from_string(ui_info);
  }
  catch(const Glib::Error& ex)
  {
    std::cerr << "не удалось создать меню: " << ex.what();
  }

//Создание виджетов меню и панели инструментов и добавление их в контейнерный виджет:
  Glib::RefPtr<Glib::Object> object =
    m_refBuilder->get_object("menu-example");
  Glib::RefPtr<Gio::Menu> gmenu =
    Glib::RefPtr<Gio::Menu>::cast_dynamic(object);
  if(!gmenu)
    g_warning("Экземпляр класса Gio::Menu не найден");

Gtk::MenuBar* pMenubar = new Gtk::MenuBar(gmenu);
  m_VBox.pack_start(*pMenubar, Gtk::PACK_SHRINK);

/* TODO:
  Gtk::Widget* pToolbar = m_refBuilder->get_widget("/ToolBar") ;
  if(pToolbar)
    m_VBox.pack_start(*pToolbar, Gtk::PACK_SHRINK);
*/
}

void ExampleWindow::on_printoperation_status_changed(
        const Glib::RefPtr<PrintFormOperation>& operation)
{
  Glib::ustring status_msg;

if (operation->is_finished())
  {
    status_msg = "Печать закончена.";
  }
  else
  {
    //Вы также должны использовать метод get_status().
    status_msg = operation->get_status_string();
  }

m_Statusbar.push(status_msg, m_ContextId);
}

void ExampleWindow::on_printoperation_done(Gtk::PrintOperationResult result,
        const Glib::RefPtr<PrintFormOperation>& operation)
{
  //Печать "завершается" после обработки данных для печати.

if (result == Gtk::PRINT_OPERATION_RESULT_ERROR)
  {
    Gtk::MessageDialog err_dialog(*this, "Ошибка при печати данных формы", false,
            Gtk::MESSAGE_ERROR, Gtk::BUTTONS_OK, true);
    err_dialog.run();
  }
  else if (result == Gtk::PRINT_OPERATION_RESULT_APPLY)
  {
    //Обновление параметров объекта настроек печати PrintSettings на основе параметров текущего объекта операции печати PrintOperation:
    m_refSettings = operation->get_print_settings();
  }

if (! operation->is_finished())
  {
    //Мы установим обработчик сигналов "status-changed" для отслеживания статуса и
    //обновления данных строки состояния. В дополнение к этому, вы можете, к примеру,
    //сформировать список активных операций печати или вывести диалог с демонстрацией степени выполнения печати.
    operation->signal_status_changed().connect(sigc::bind(sigc::mem_fun(*this,
                    &ExampleWindow::on_printoperation_status_changed),
                operation));
  }
}

void ExampleWindow::print_or_preview(Gtk::PrintOperationAction print_action)
{
  //Создание нового объекта операции печати PrintOperation на основе наших объектов настроек страницы PageSetup и настроек печати PrintSettings:
  //(Мы используем наш унаследованный от класса PrintOperation класс)
  Glib::RefPtr<PrintFormOperation> print = PrintFormOperation::create();

print->set_name(m_NameEntry.get_text() + " " + m_SurnameEntry.get_text());
  print->set_comments(m_refTextBuffer->get_text(false /*Не включать невидимые символы*/));

print->set_track_print_status();
  print->set_default_page_setup(m_refPageSetup);
  print->set_print_settings(m_refSettings);

print->signal_done().connect(sigc::bind(sigc::mem_fun(*this,
                  &ExampleWindow::on_printoperation_done), print));
  try
  {
    print->run(print_action /* печать или предварительный просмотр */, *this);
  }
  catch (const Gtk::PrintError& ex)
  {
    //Обратитесь к документации для уточнения кодов ошибок типа Gtk::PrintError.
    std::cerr << "Произошла ошибка при попытке запуска операции печати:"
        << ex.what() << std::endl;
  }
}

void ExampleWindow::on_menu_file_new()
{
  //Очистка полей ввода строк и текста:
  m_NameEntry.set_text("");
  m_SurnameEntry.set_text("");
  m_refTextBuffer->set_text("");
  m_TextView.set_buffer(m_refTextBuffer);
}

void ExampleWindow::on_menu_file_page_setup()
{
  //Показ диалога настроек страницы с существующими настройками:
  Glib::RefPtr<Gtk::PageSetup> new_page_setup =
      Gtk::run_page_setup_dialog(*this, m_refPageSetup, m_refSettings);

//Сохранение установленных с помощью диалога настроек страницы для последующей
  //печати, предварительного просмотра или повторного показа диалога:
  m_refPageSetup = new_page_setup;
}

void ExampleWindow::on_menu_file_print_preview()
{
  print_or_preview(Gtk::PRINT_OPERATION_ACTION_PREVIEW);
}

void ExampleWindow::on_menu_file_print()
{
  print_or_preview(Gtk::PRINT_OPERATION_ACTION_PRINT_DIALOG);
}

void ExampleWindow::on_menu_file_quit()
{
  hide();
}

Файл: main.cc (Для использования совместно с gtkmm 3, а не с gtkmm 2)

Следующий раздел : 21.Недавно использованные документы.