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

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

Программирование с использованием gtkmm 3. Виджет древовидного представления данных (TreeView)

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

9.8.4. Захват и перемещение элементов (Drag and Drop)

Данный пример очень похож на пример работы с моделью представления данных для хранения деревьев, но в данном случае используются еще 2 дополнительных столбца, которые предназначены для указания на то, может ли строка захватываться и может ли она принимать захваченные и перемещаемые строки. В примере используется унаследованный от класса Gtk::TreeStore класс, в котором реализовано перекрытие виртуальных методов таким способом, как это описано в разделе "Механизм захвата и перемещения элементов Drag and Drop".

Рисунок 9-6: Виджет древовидного представления данных с поддержкой захвата и перемещения строк

Исходный код

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

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

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

#include <iostream>
#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Button_Quit("_Выход", true)
{
  set_title("Пример использования виджета, представленного классом Gtk::TreeView с поддержкой захвата и перемещения строк (Drag and Drop)");
  set_border_width(5);
  set_default_size(400, 200);

add(m_VBox);

//Добавление виджета древовидного представления в окно прокрутки с кнопкой под ним:
  m_ScrolledWindow.add(m_TreeView);

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

m_VBox.pack_start(m_ScrolledWindow);
  m_VBox.pack_start(m_ButtonBox, Gtk::PACK_SHRINK);

m_ButtonBox.pack_start(m_Button_Quit, Gtk::PACK_SHRINK);
  m_ButtonBox.set_border_width(5);
  m_ButtonBox.set_layout(Gtk::BUTTONBOX_END);
  m_Button_Quit.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_quit) );

//Создание модели представления данных:
  //Используется наш дочерний класс модели с перекрытием некоторых виртуальных
  //функций классов Gtk::TreeDragDest и Gtk::TreeDragSource:
  //Столбцы описываются в рамках дочернего класса представления данных.
  m_refTreeModel = TreeModel_Dnd::create();
  m_TreeView.set_model(m_refTreeModel);

//Активация возможности захвата и перемещения (Drag-and-Drop) строк виджета:
  //Также обратитесь к перекрытым функциям *_vfunc дочернего класса модели представления.
  m_TreeView.enable_model_drag_source();
  m_TreeView.enable_model_drag_dest();

//Заполнение модели представления данных
  Gtk::TreeModel::Row row = *(m_refTreeModel->append());
  row[m_refTreeModel->m_Columns.m_col_id] = 1;
  row[m_refTreeModel->m_Columns.m_col_name] = "Billy Bob";
  row[m_refTreeModel->m_Columns.m_col_draggable] = true;
  row[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

Gtk::TreeModel::Row childrow = *(m_refTreeModel->append(row.children()));
  childrow[m_refTreeModel->m_Columns.m_col_id] = 11;
  childrow[m_refTreeModel->m_Columns.m_col_name] = "Billy Bob Junior";
  childrow[m_refTreeModel->m_Columns.m_col_draggable] = true;
  childrow[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

childrow = *(m_refTreeModel->append(row.children()));
  childrow[m_refTreeModel->m_Columns.m_col_id] = 12;
  childrow[m_refTreeModel->m_Columns.m_col_name] = "Sue Bob";
  childrow[m_refTreeModel->m_Columns.m_col_draggable] = true;
  childrow[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

row = *(m_refTreeModel->append());
  row[m_refTreeModel->m_Columns.m_col_id] = 2;
  row[m_refTreeModel->m_Columns.m_col_name] = "Joey Jojo";
  row[m_refTreeModel->m_Columns.m_col_draggable] = true;
  row[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

row = *(m_refTreeModel->append());
  row[m_refTreeModel->m_Columns.m_col_id] = 3;
  row[m_refTreeModel->m_Columns.m_col_name] = "Rob McRoberts";
  row[m_refTreeModel->m_Columns.m_col_draggable] = true;
  row[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

childrow = *(m_refTreeModel->append(row.children()));
  childrow[m_refTreeModel->m_Columns.m_col_id] = 31;
  childrow[m_refTreeModel->m_Columns.m_col_name] = "Xavier McRoberts";
  childrow[m_refTreeModel->m_Columns.m_col_draggable] = true;
  childrow[m_refTreeModel->m_Columns.m_col_receivesdrags] = true;

//Добавление столбцов виджета древовидного представления:
  m_TreeView.append_column("Ид.", m_refTreeModel->m_Columns.m_col_id);
  m_TreeView.append_column("Имя", m_refTreeModel->m_Columns.m_col_name);
  m_TreeView.append_column_editable("Строка захватывается",
          m_refTreeModel->m_Columns.m_col_draggable);
  m_TreeView.append_column_editable("Строки принимаются",
          m_refTreeModel->m_Columns.m_col_receivesdrags);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

Файл: main.cc (Для работы совместно с gtkmm 3, а не с gtkmm 2)

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

#include "treemodel_dnd.h"
#include <iostream>

TreeModel_Dnd::TreeModel_Dnd()
{
  //Мы не можем вызвать просто Gtk::TreeModel(m_Columns) при инициализации объекта,
  //так как объект m_Columns не существует в момент работы конструктора базового класса.
  //Также мы не можем использовать метод хранения данных static m_Columns, так как
  //экземпляр класса будет создаваться перед запуском системы типов gtkmm.
  //Исходя из этого, мы используем метод,который может вызываться сразу после создания объекта:
  set_column_types(m_Columns);
}

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

bool
TreeModel_Dnd::row_draggable_vfunc(const Gtk::TreeModel::Path& path) const
{
  // Значение из столбца "Строка захватывается" должно устанавливать, может ли эта строка
  // быть захвачена:

//TODO: Добавить версию использования метода get_iter постоянного объекта модели представления данных:
  TreeModel_Dnd* unconstThis = const_cast<TreeModel_Dnd*>(this);
  const_iterator iter = unconstThis->get_iter(path);
  //const_iterator iter = get_iter(path);
  if(iter)
  {
    Row row = *iter;
    bool is_draggable = row[m_Columns.m_col_draggable];
    return is_draggable;
  }

return Gtk::TreeStore::row_draggable_vfunc(path);
}

bool
TreeModel_Dnd::row_drop_possible_vfunc(const Gtk::TreeModel::Path& dest,
        const Gtk::SelectionData& selection_data) const
{
  //Значение из столбца "Строки принимаются" должно устанавливать, может ли ли строка
  //быть перемещена в него:

//параметр dest представляет будущий путь к строке после ее перемещения:
  //Но в данном случае мы больше заинтересованы в родительской строке:
  Gtk::TreeModel::Path dest_parent = dest;
  bool dest_is_not_top_level = dest_parent.up();
  if(!dest_is_not_top_level || dest_parent.empty())
  {
    //Пользователь хочет переместить что-либо на верхний уровень.
    //Давайте в любом случае разрешать такое действие.
  }
  else
  {
    //Получение итератора для строки с заданным путем:
    //Мы не должны использовать постоянные значения (const). В будущей версии
    //gtkmm это требование не будет жестким.
    //TODO: Добавить версию использования метода get_iter постоянного объекта модели представления данных:
    TreeModel_Dnd* unconstThis = const_cast<TreeModel_Dnd*>(this);
    const_iterator iter_dest_parent = unconstThis->get_iter(dest_parent);
    //const_iterator iter_dest_parent = get_iter(dest);
    if(iter_dest_parent)
    {
      Row row = *iter_dest_parent;
      bool receives_drags = row[m_Columns.m_col_receivesdrags];
      return receives_drags;
    }
  }

//Вы также можете исследовать захваченную строку (с помощью параметра selection_data);
  //если же вам нужно исследовать обе строки для того, чтобы принять решение о
  //допустимости перемещения строки, вы должны использовать следующий код:
  //TODO: Добавить версию использования метода постоянного объекта get_from_selection_data(): Glib::RefPtr<const
  //Gtk::TreeModel> refThis = Glib::RefPtr<const Gtk::TreeModel>(this);
  //
  //Glib::RefPtr<Gtk::TreeModel> refThis =
  //Glib::RefPtr<Gtk::TreeModel>(const_cast<TreeModel_Dnd*>(this));
  //refThis->reference(); //, true /* создание копии */)
  //Gtk::TreeModel::Path path_dragged_row;
  //Gtk::TreeModel::Path::get_from_selection_data(selection_data, refThis,
  //path_dragged_row);

return Gtk::TreeStore::row_drop_possible_vfunc(dest, selection_data);
}

9.8.5. Всплывающие контекстные меню

Данный пример очень похож на пример использования модели представления данных для хранения списков (ListStore), но в нем создается унаследованный от класса Gtk::TreeView дочерний класс, в котором реализуется перекрытие метода button_press_event с инкапсуляцией кода модели представления данных. Обратитесь к разделу "Всплывающее контекстное меню" для ознакомления с подробностями реализации.

Рисунок 9-7: Виджет древовидного представления данных с всплывающим контекстным меню

Исходный код

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

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

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

#include "treeview_withpopup.h"
#include <iostream>

TreeView_WithPopup::TreeView_WithPopup()
{
  //Создание модели представления данных:
  m_refTreeModel = Gtk::ListStore::create(m_Columns);
  set_model(m_refTreeModel);

//Заполнение модели виджета древовидного представления данных
  Gtk::TreeModel::Row row = *(m_refTreeModel->append());
  row[m_Columns.m_col_id] = 1;
  row[m_Columns.m_col_name] = "Нажмите с помощью правой кнопки мыши здесь";

row = *(m_refTreeModel->append());
  row[m_Columns.m_col_id] = 2;
  row[m_Columns.m_col_name] = "или здесь";

row = *(m_refTreeModel->append());
  row[m_Columns.m_col_id] = 3;
  row[m_Columns.m_col_name] = "или здесь для вызова всплывающего контекстного меню";

//Добавление столбцов виджета древовидного представления данных:
  append_column("Ид.", m_Columns.m_col_id);
  append_column("Имя", m_Columns.m_col_name);

//Заполнение всплывающего меню:
  Gtk::MenuItem* item = Gtk::manage(new Gtk::MenuItem("_Редактировать", true));
  item->signal_activate().connect(
    sigc::mem_fun(*this, &TreeView_WithPopup::on_menu_file_popup_generic) );
  m_Menu_Popup.append(*item);
    
  item = Gtk::manage(new Gtk::MenuItem("_Обработать", true));
  item->signal_activate().connect(
    sigc::mem_fun(*this, &TreeView_WithPopup::on_menu_file_popup_generic) );
  m_Menu_Popup.append(*item);
    
  item = Gtk::manage(new Gtk::MenuItem("_Удалить", true));
  item->signal_activate().connect(
    sigc::mem_fun(*this, &TreeView_WithPopup::on_menu_file_popup_generic) );
  m_Menu_Popup.append(*item);

m_Menu_Popup.accelerate(*this);
  m_Menu_Popup.show_all(); //Показать все элементы меню в момент показа меню

#ifndef GLIBMM_DEFAULT_SIGNAL_HANDLERS_ENABLED
  signal_button_press_event()
    .connect(sigc::mem_fun(*this, &TreeView_WithPopup::on_button_press_event), false);
#endif
}

TreeView_WithPopup::~TreeView_WithPopup()
{
}

bool TreeView_WithPopup::on_button_press_event(GdkEventButton* event)
{
  bool return_value = false;

//Вызов метода базового класса для корректной обработки события и выполнения
  //такого действия, как выделение строки после нажатия на правую кнопку мыши:
  return_value = TreeView::on_button_press_event(event);

//После этого выполнение необходимых нам действий:
  if( (event->type == GDK_BUTTON_PRESS) && (event->button == 3) )
  {
    m_Menu_Popup.popup(event->button, event->time);
  }

return return_value;
}

void TreeView_WithPopup::on_menu_file_popup_generic()
{
  std::cout << "Элемент всплывающего меню был выбран." << std::endl;

Glib::RefPtr<Gtk::TreeView::Selection> refSelection = get_selection();
  if(refSelection)
  {
    Gtk::TreeModel::iterator iter = refSelection->get_selected();
    if(iter)
    {
      int id = (*iter)[m_Columns.m_col_id];
      std::cout << "  Идентификатор выбранной строки=" << id << std::endl;
    }
  }
}

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

#include <iostream>
#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Button_Quit("Выход")
{
  set_title("Пример использования виджета, представленного классом Gtk::TreeView (совместно с моделью представления данных для хранения списков на основе класса Gtk::ListStore)");
  set_border_width(5);
  set_default_size(400, 200);

add(m_VBox);

//Добавление виджета древовидного представления данных в окно прокрутки с кнопкой под ним:
  m_ScrolledWindow.add(m_TreeView);

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

m_VBox.pack_start(m_ScrolledWindow);
  m_VBox.pack_start(m_ButtonBox, Gtk::PACK_SHRINK);

m_ButtonBox.pack_start(m_Button_Quit, Gtk::PACK_SHRINK);
  m_ButtonBox.set_border_width(5);
  m_ButtonBox.set_layout(Gtk::BUTTONBOX_END);
  m_Button_Quit.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_button_quit) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

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

Следующий раздел : 10. Раскрывающиеся списки (Combo Boxes).