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

Библиотека сайта 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.3. Редактируемые ячейки

Данный пример идентичен примеру работы с моделью представления данных для хранения списков, но в нем используется метод TreeView::append_column_editable() вместо TreeView::append_column().

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

Исходный код

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

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

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

protected:
  //Обработчики сигналов:
  void on_button_quit();

void treeviewcolumn_validated_on_cell_data(Gtk::CellRenderer* renderer, const Gtk::TreeModel::iterator& iter);
  void cellrenderer_validated_on_editing_started(Gtk::CellEditable* cell_editable, const Glib::ustring& path);
  void cellrenderer_validated_on_edited(const Glib::ustring& path_string, const Glib::ustring& new_text);

//Столбцы модели представления данных:
  class ModelColumns : public Gtk::TreeModel::ColumnRecord
  {
  public:

ModelColumns()
    { add(m_col_id); add(m_col_name); add(m_col_foo); add(m_col_number); add(m_col_number_validated); }

Gtk::TreeModelColumn<unsigned int> m_col_id;
    Gtk::TreeModelColumn<Glib::ustring> m_col_name;
    Gtk::TreeModelColumn<bool> m_col_foo;
    Gtk::TreeModelColumn<int> m_col_number;
    Gtk::TreeModelColumn<int> m_col_number_validated;
  };

ModelColumns m_Columns;

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

Gtk::ScrolledWindow m_ScrolledWindow;
  Gtk::TreeView m_TreeView;
  Glib::RefPtr<Gtk::ListStore> m_refTreeModel;

Gtk::ButtonBox m_ButtonBox;
  Gtk::Button m_Button_Quit;

//Для столбца с проверкой вводимых значений:
  //Также может быть использован объект прорисовки ячеек на основе класса Gtk::CellRendererSpin или Gtk::CellRendererProgress:
  Gtk::CellRendererText m_cellrenderer_validated;
  Gtk::TreeView::Column m_treeviewcolumn_validated;
  bool m_validate_retry;
  Glib::ustring m_invalid_text_for_retry;
};

#endif //GTKMM_EXAMPLEWINDOW_H

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

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

using std::sprintf;
using std::strtol;

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Button_Quit("Выход"),
  m_validate_retry(false)
{
  set_title("Виджет древовидного представления данных на основе класса Gtk::TreeView с редактируемыми ячейками");
  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) );

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

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

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

row = *(m_refTreeModel->append());

row[m_Columns.m_col_id] = 3;
  row[m_Columns.m_col_name] = "Rob McRoberts";
  row[m_Columns.m_col_foo] = false;
  row[m_Columns.m_col_number] = 30;

//Добавление столбцов виджета древовидного представления данных:
  //Мы используем методы *_editable для большинства столбцов,
  //так как стандартных функций редактирования в данном случае достаточно:
  m_TreeView.append_column_editable("Ид.", m_Columns.m_col_id);
  m_TreeView.append_column_editable("Имя", m_Columns.m_col_name);
  m_TreeView.append_column_editable("foo", m_Columns.m_col_foo);
  m_TreeView.append_column_numeric_editable("foo", m_Columns.m_col_number,
          "%010d");

//Для этого столбца мы самостоятельно создаем объект прорисовки ячеек и устанавливаем
  //наши обработчики сигналов для проверки введенных пользователем данных, а также для
  //управления способом их вывода.
  m_treeviewcolumn_validated.set_title("проверено (<10)");
  m_treeviewcolumn_validated.pack_start(m_cellrenderer_validated);
  m_TreeView.append_column(m_treeviewcolumn_validated);

//Передача информации о методе вывода значений модели объекту столбца виджета:
  m_treeviewcolumn_validated.set_cell_data_func(m_cellrenderer_validated,
          sigc::mem_fun(*this,
              &ExampleWindow::treeviewcolumn_validated_on_cell_data) );

//Включение поддержки операций редактирования в объекте прорисовки ячеек и обработка сигналов, указывающих на редактирование:
  m_cellrenderer_validated.property_editable() = true;

m_cellrenderer_validated.signal_editing_started().connect(
          sigc::mem_fun(*this,
        &ExampleWindow::cellrenderer_validated_on_editing_started) );

m_cellrenderer_validated.signal_edited().connect( sigc::mem_fun(*this,
              &ExampleWindow::cellrenderer_validated_on_edited) );

//Если бы использовался класс Gtk::CellRendererSpin вам пришлось бы передать объект установки диапазонов значений:
  //m_cellrenderer_validated.property_adjustment() = m_spin_adjustment;

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

void ExampleWindow::treeviewcolumn_validated_on_cell_data(
        Gtk::CellRenderer* /* renderer */,
        const Gtk::TreeModel::iterator& iter)
{
  //Получение значения от модели и отображение его соответствующим образом в представлении:
  if(iter)
  {
    Gtk::TreeModel::Row row = *iter;
    int model_value = row[m_Columns.m_col_number_validated];

//Это всего лишь пример.
    //В данном случае было бы проще использовать методы append_column_editable() или
    //append_column_numeric_editable()
    char buffer[32];
    sprintf(buffer, "%d", model_value);

Glib::ustring view_text = buffer;
    m_cellrenderer_validated.property_text() = view_text;
  }
}

void ExampleWindow::cellrenderer_validated_on_editing_started(
        Gtk::CellEditable* cell_editable, const Glib::ustring& /* path */)
{
  //Редактирование начинается с ранее введенного (но некорректного) текста
  //в том случае, если мы позволяем пользователю отредактировать некорректное значение. 
  if(m_validate_retry)
  {
    //Это экземпляр класса Gtk::CellEditable внутри экземпляра класса Gtk::CellRenderer. 
    Gtk::CellEditable* celleditable_validated = cell_editable;

//Обычно это виджет, представленный классом Gtk::Entry, по крайней мере, при использовании класса Gtk::CellRendererText:
    Gtk::Entry* pEntry = dynamic_cast<Gtk::Entry*>(celleditable_validated);
    if(pEntry)
    {
      pEntry->set_text(m_invalid_text_for_retry);
      m_validate_retry = false;
      m_invalid_text_for_retry.clear();
    }
  }

}

void ExampleWindow::cellrenderer_validated_on_edited(
        const Glib::ustring& path_string,
        const Glib::ustring& new_text)
{
  Gtk::TreePath path(path_string);

//Преобразование введенного текста в целочисленное значение, которое может быть добавлено в столбец нашей модели:
  char* pchEnd = 0;
  int new_value = strtol(new_text.c_str(), &pchEnd, 10);

if(new_value > 10)
  {
    //Предотвращение ввода чисел больше 10.

//Сообщение для пользователя:
    Gtk::MessageDialog dialog(*this,
            "Число должно быть меньше 10. Пожалуйста, введите его снова.",
            false, Gtk::MESSAGE_ERROR);
    dialog.run();

//Начало операции повторного редактирования некорректного текста, позволяющей пользователю исправить его.
    //Реальное приложение, скорее всего, должно позволить пользователю вернуться к
    //предыдущему тексту.

//Установка текста для использования в рамках обработчика сигнала "start_editing":
    m_invalid_text_for_retry = new_text;
    m_validate_retry = true;

//Начало повторного редактирования текста:
    m_TreeView.set_cursor(path, m_treeviewcolumn_validated,
            m_cellrenderer_validated, true /* start_editing */);
  }
  else
  {
    //Получение строки представления данных на основе соответствующего пути:
    Gtk::TreeModel::iterator iter = m_refTreeModel->get_iter(path);
    if(iter)
    {
      Gtk::TreeModel::Row row = *iter;

//Внесение нового значения в модель:
      row[m_Columns.m_col_number_validated] = new_value;
    }
  }
}

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

Следующий раздел : 9.8.4. Захват и перемещение элементов.