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

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

Программирование с использованием gtkmm 3. Раскрывающиеся списки (Combo Boxes)

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

10.5. Простой пример с текстовыми элементами списка

Рисунок 10-2: Раскрывающийся список с текстовыми элементами (ComboBoxText)

Исходный код

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

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

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

10.6. Раскрывающийся список с полем ввода строки

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

10.6.1. Текстовый столбец модели

Так как поле ввода строки может взаимодействовать с раскрывающимся списком вариантов выбора, вы можете указать на столбец вашей модели, который должен являться текстовым столбцом с помощью метода set_entry_text_column(). К примеру, это может сделано следующим образом:

m_combo.set_entry_text_column(m_columns.m_col_name);

После этого в момент выбора варианта из раскрывающегося списка текстовое значение из установленного столбца будет размещаться в поле ввода строки.

10.6.2. Поле ввода строки

Так как пользователь имеет возможность ввода произвольного текста, активной строки модели не достаточно для того, чтобы выяснить, какой текст ввел пользователь. Следовательно, вы должны получить объект виджета ввода строки с помощью метода Gtk::ComboBox::get_entry() и использовать метод get_text() полученного объекта.

10.6.3. Обработка изменений

При обработке введенного пользователем произвольного текста установка обработчика сигнала "changed", который генерируется при вводе пользователем каждого из символов, может оказаться недостаточной. При этом он не генерируется в тот момент, когда пользователь нажимает клавишу Enter. Нажатие на клавишу Enter или перемещение фокуса ввода на другой виджет может указывать на то, что пользователь закончил ввод текста. Для получения уведомлений о наступлении этих событий следует устанавливать обработчики сигналов "activate" и "focus_out_event" виджета ввода строки следующим образом:

Gtk::Entry* entry = m_Combo.get_entry();
if (entry)
{
  // Виджет ввода строки должен получать уведомления о наступлении событий перемещения фокуса ввода.
  entry->add_events(Gdk::FOCUS_CHANGE_MASK);

  // Альтернативным вариантом является установка обработчика m_Combo.signal_changed().
  entry->signal_changed().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_entry_changed) );

  entry->signal_activate().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_entry_activate) );

  entry->signal_focus_out_event().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_entry_focus_out_event) );
}

Сигналы "changed" как виджета раскрывающегося списка, так и виджета ввода строки генерируются при каждом изменении. Не имеет значения, для какого из сигналов вы установили обработчик. При этом в данном случае работоспособный обработчик сигнала "focus_out_event" может устанавливаться только для виджета ввода строки.

События оконной системы X описываются в подробностях в разделе приложения под названием "Сигналы для событий оконной системы X".

10.6.4. Полнофункциональный пример использования списка с полем ввода строки

Рисунок 10-3: Раскрывающийся список с полем ввода строки

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_Combo(true /* has_entry*/)
{
  set_title("Пример использования раскрывающегося списка с полем ввода строки");

//Создание модели представления данных:
  //m_refTreeModel = Gtk::TreeStore::create(m_Columns);
  m_refTreeModel = Gtk::ListStore::create(m_Columns);
  m_Combo.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";
  /*
  Gtk::TreeModel::Row childrow = *(m_refTreeModel->append(row.children()));
  childrow[m_Columns.m_col_id] = 11;
  childrow[m_Columns.m_col_name] = "Billy Bob Junior";

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

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

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

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

//Добавление столбцов модели представления данных в раскрывающийся список
  //(который является своего рода представлением), выводящий их стандартным образом:
  //Данные автоматически выводятся после того, как мы используем метод set_entry_text_column().
  //m_Combo.pack_start(m_Columns.m_col_id);
  m_Combo.pack_start(m_Columns.m_col_name);

m_Combo.set_entry_text_column(m_Columns.m_col_id);
  m_Combo.set_active(1);

//Добавление раскрывающегося списка в окно.
  add(m_Combo);

//Установка обработчиков сигналов:
  Gtk::Entry* entry = m_Combo.get_entry();
  if (entry)
  {
    // Виджет ввода строки должен получать уведомления о наступлении событий переноса фокуса ввода.
    entry->add_events(Gdk::FOCUS_CHANGE_MASK);
    // Альтернативным вариантом является установка обработчика сигнала m_Combo.signal_changed().
    entry->signal_changed().connect(sigc::mem_fun(*this,
      &ExampleWindow::on_entry_changed) );
    entry->signal_activate().connect(sigc::mem_fun(*this,
      &ExampleWindow::on_entry_activate) );
    m_ConnectionFocusOut = entry->signal_focus_out_event().
      connect(sigc::mem_fun(*this, &ExampleWindow::on_entry_focus_out_event) );
  }
  else
    std::cout << "Раскрывающийся список без поля ввода строки ???" << std::endl;

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
  // Сигнал focus_out может генерироваться в момент удаления объекта m_Combo.
  // При этом обработчик сигнала может генерировать критические предупреждения при
  // вызове в условиях частичного удаления объекта m_Combo.
  m_ConnectionFocusOut.disconnect();
}

void ExampleWindow::on_entry_changed()
{
  Gtk::Entry* entry = m_Combo.get_entry();
  if (entry)
  {
    std::cout << "on_entry_changed(): Строка модели=" << m_Combo.get_active_row_number()
      << ", Идентификатор=" << entry->get_text() << std::endl;
  }
}

void ExampleWindow::on_entry_activate()
{
  Gtk::Entry* entry = m_Combo.get_entry();
  if (entry)
  {
    std::cout << "on_entry_activate(): Строка модели=" << m_Combo.get_active_row_number()
      << ", Идентификатор=" << entry->get_text() << std::endl;
  }
}

bool ExampleWindow::on_entry_focus_out_event(GdkEventFocus* /* event */)
{
  Gtk::Entry* entry = m_Combo.get_entry();
  if (entry)
  {
    std::cout << "on_entry_focus_out_event(): Строка модели=" << m_Combo.get_active_row_number()
      << ", Идентификатор=" << entry->get_text() << std::endl;
    return true;
  }
  return false;
}

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

10.6.5. Простой пример использования списка с текстовыми элементами и полем ввода строки

Рисунок 10-4: Раскрывающийся список с текстовыми элементами и полем ввода строки

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_Combo(true /* has_entry */)
{
  set_title("Пример использования раскрывающегося списка с текстовыми элементами и полем ввода строки");

//Заполнение раскрывающегося списка:
  m_Combo.append("Что-либо");
  m_Combo.append("Что-то другое");
  m_Combo.append("Что-либо или что-то другое");
  m_Combo.set_active(0);

add(m_Combo);

//Установка обработчиков сигналов:
  Gtk::Entry* entry = m_Combo.get_entry();
  // Альтернативным решением является установка обработчика сигнала entry->signal_changed().
  m_Combo.signal_changed().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_combo_changed) );
  if (entry)
  {
    // Виджет ввода строки должен получать сигналы переноса фокуса ввода.
    entry->add_events(Gdk::FOCUS_CHANGE_MASK);
    entry->signal_activate().connect(sigc::mem_fun(*this,
      &ExampleWindow::on_entry_activate) );
    m_ConnectionFocusOut = entry->signal_focus_out_event().
      connect(sigc::mem_fun(*this, &ExampleWindow::on_entry_focus_out_event) );
  }
  else
    std::cout << "Раскрывающийся список без поля ввода строки ???" << std::endl;

m_Combo.property_has_frame() = false;
  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
  // Сигнал focus_out может генерироваться при удалении объекта m_Combo.
  // При этом обработчик сигнала может генерировать критические предупреждения при
  // вызове в условиях частичного удаления объекта m_Combo.
  m_ConnectionFocusOut.disconnect();
}

void ExampleWindow::on_combo_changed()
{
  std::cout << "on_combo_changed(): Строка модели=" << m_Combo.get_active_row_number()
    << ", Текст=" << m_Combo.get_active_text() << std::endl;
}

void ExampleWindow::on_entry_activate()
{
  std::cout << "on_entry_activate(): Строка модели=" << m_Combo.get_active_row_number()
    << ", Текст=" << m_Combo.get_active_text() << std::endl;
}

bool ExampleWindow::on_entry_focus_out_event(GdkEventFocus* /* event */)
{
  std::cout << "on_entry_focus_out_event(): Строка модели=" << m_Combo.get_active_row_number()
    << ", Текст=" << m_Combo.get_active_text() << std::endl;
  return true;
}

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

Следующий раздел : Поле ввода текста (TextView).