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

Библиотека сайта 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
Перевод: А.Панин

8.2.4. Контейнеры для кнопок (ButtonBoxes)

Контейнеры для кнопок предоставляют простой способ быстрой упаковки группы кнопок. Ориентация этих контейнеров может быть как горизонтальной, так и вертикальной.

Контейнеры для кнопок позволяют придать приложениям унифицированный вид, так как они используют такие стандартные параметры, как промежутки между кнопками, а также параметры упаковки.

Кнопки добавляются в контейнеры для кнопок с помощью метода add().

Контейнеры для кнопок поддерживают несколько стилей размещения кнопок. Стиль может быть получен с помощью метода get_layout() и впоследствии модифицирован с помощью метода set_layout().

Справочная информация

8.2.4.1. Пример

Рисунок 8-9: Контейнер для кнопок (ButtonBox)

Исходный код

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

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

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

#include "examplewindow.h"
#include "examplebuttonbox.h"

ExampleWindow::ExampleWindow()
: m_VBox_Main(Gtk::ORIENTATION_VERTICAL),
  m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Frame_Horizontal("Горизонтальные контейнеры для кнопок"),
  m_Frame_Vertical("Вертикальные контейнеры для кнопок")
{
  set_title("Пример использования класса Gtk::ButtonBox");
  add(m_VBox_Main);

m_VBox_Main.pack_start(m_Frame_Horizontal, Gtk::PACK_EXPAND_WIDGET, 10);

//Контейнер для кнопок с горизонтальной ориентацией:
  m_VBox.set_border_width(10);
  m_Frame_Horizontal.add(m_VBox);

m_VBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(true, "Spread (spacing 40)", 40,
                  Gtk::BUTTONBOX_SPREAD)),
          Gtk::PACK_EXPAND_WIDGET, 0);

m_VBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(true, "Edge (spacing 30)", 30,
                  Gtk::BUTTONBOX_EDGE)),
          Gtk::PACK_EXPAND_WIDGET, 5);

m_VBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(true, "Start (spacing 20)", 20,
                  Gtk::BUTTONBOX_START)),
          Gtk::PACK_EXPAND_WIDGET, 5);

m_VBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(true, "end (spacing 10)", 10,
                  Gtk::BUTTONBOX_END)),
          Gtk::PACK_EXPAND_WIDGET, 5);

//Контейнер для кнопок с вертикальной ориентацией:
  m_VBox_Main.pack_start(m_Frame_Vertical, Gtk::PACK_EXPAND_WIDGET, 10);

m_HBox.set_border_width(10);
  m_Frame_Vertical.add(m_HBox);

m_HBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(false, "Spread (spacing 5)", 5,
                  Gtk::BUTTONBOX_SPREAD)),
          Gtk::PACK_EXPAND_WIDGET, 0);

m_HBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(false, "Edge (spacing 30)", 30,
                  Gtk::BUTTONBOX_EDGE)),
          Gtk::PACK_EXPAND_WIDGET, 5);

m_HBox.pack_start(*Gtk::manage(
              new ExampleButtonBox(false, "Start (spacing 20)", 20,
                  Gtk::BUTTONBOX_START)),
          Gtk::PACK_EXPAND_WIDGET, 5);

m_HBox.pack_start(*Gtk::manage(new ExampleButtonBox(false, "End (spacing 10)",
                  10, Gtk::BUTTONBOX_END)),
          Gtk::PACK_EXPAND_WIDGET, 5);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

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

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

8.2.5. Сетка (Grid)

Сетка позволяет динамически размещать дочерние виджеты с упорядочиванием по строкам и столбцам. Размеры сетки не должны указываться при использовании конструктора.

Дочерние виджеты могут растягиваться на множество строк или столбцов путем использования метода attach() или путем размещения виджета рядом с уже размещенным виджетом в сетке с помощью метода attach_next_to(). Для отдельных строк и столбцов сетки может быть принудительно установлена равная высота и ширина с помощью методов set_row_homogeneous() и set_column_homogeneous().

Вы можете установить параметры выравнивания (margin) и расширения (expand) дочерних виджетов для того, чтобы управлять использованием пустого пространства и поведением виджетов при изменении размеров сетки.

Справочная информация

8.2.5.1. Пример

В данном примере создается окно с тремя кнопками, размещенными с использованием сетки. Первые две кнопки располагаются в верхней строке слева направо. Третья кнопка привязана к первой кнопке, расположена под ней в строке ниже и расширена на два столбца.

Рисунок 8-10: Сетка (Grid)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_button_1("кнопка 1"),
  m_button_2("кнопка 2"),
  m_button_quit("Выход")
{
  set_title("Пример использования класса Gtk::Grid");
  set_border_width(12);

add(m_grid);

m_grid.add(m_button_1);
  m_grid.add(m_button_2);
  m_grid.attach_next_to(m_button_quit, m_button_1, Gtk::POS_BOTTOM, 2, 1);

m_button_1.signal_clicked().connect(
    sigc::bind<Glib::ustring>( sigc::mem_fun(*this,
      &ExampleWindow::on_button_numbered), "кнопка 1") );
  m_button_2.signal_clicked().connect(
    sigc::bind<Glib::ustring>( sigc::mem_fun(*this,
      &ExampleWindow::on_button_numbered), "кнопка 2") );

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();
}

void
ExampleWindow::on_button_numbered(const Glib::ustring& data)
{
  std::cout << data << " была нажата" << std::endl;
}

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

8.2.6. Таблица (Table)

Виджет, представленный классом Gtk::Table, позволяет размещать виджеты в сетке, аналогично виджету, представленному классом Gtk::Grid.

Класс Gtk::Table отмечен как устаревший начиная с версии 3.4 gtkmm и не должен использоваться в новом коде. Вместо него следует использовать класс Gtk::Grid.

8.2.7. Набор страниц с вкладками (Notebook)

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

Методы append_page(), prepend_page() и insert_page() могут использоваться для добавления страниц и соответствующих им вкладок в виджет наборов страниц с вкладками путем передачи дочернего виджета и названия для вкладки.

Для выявления видимой на данный момент страницы следует использовать метод get_current_page(). Этот метод возвращает номер страницы, а вызов метода get_nth_page() с передачей этого номера позволяет получить указатель на сам дочерний виджет страницы.

Для программного изменения выбранной страницы может использоваться метод set_current_page().

Справочная информация

8.2.7.1. Пример

Рисунок 8-11: Набор страниц с вкладками (Notebook)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Label1("Содержимое вкладки 1"),
  m_Label2("Содержимое вкладки 2"),
  m_Button_Quit("Выход")
{
  set_title("Пример использования класса Gtk::Notebook");
  set_border_width(10);
  set_default_size(400, 200);

add(m_VBox);

//Добавление виджета наборов страниц с вкладками и кнопки внизу:
  m_Notebook.set_border_width(10);
  m_VBox.pack_start(m_Notebook);
  m_VBox.pack_start(m_ButtonBox, Gtk::PACK_SHRINK);

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

//Добавление страниц в виджет наборов страниц с вкладками:
  m_Notebook.append_page(m_Label1, "Первая страница");
  m_Notebook.append_page(m_Label2, "Вторая страница");

m_Notebook.signal_switch_page().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_notebook_switch_page) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

void ExampleWindow::on_notebook_switch_page(Gtk::Widget* /* page */, guint page_num)
{
  std::cout << "Переход на вкладку под номером " << page_num << std::endl;

//Вы также можете использовать вызов m_Notebook.get_current_page() для получения этого номера.
}

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

8.2.8. Помощник (Assistant)

Помощник позволяет разделить сложную операцию на этапы. Каждый этап представляется страницей, содержащей заголовок, дочерний виджет и рабочее пространство. Рабочее пространство помощника содержит кнопки для перехода между страницами, которые изменяют свое состояние автоматически в зависимости от типа страницы, установленного с помощью метода set_page_type().

Методы append_page(), prepend_page() и insert_page() позволяют добавлять страницы помощника, передавая дочерний виджет для каждой из страниц.

Для установления видимой на данный момент страницы следует использовать метод get_current_page() и использовать возвращенный результат при вызове метода get_nth_page(), который, в свою очередь, вернет указатель на сам виджет. Для программного изменения текущей страницы следует использовать метод set_current_page().

Для установки заголовка страницы следует использовать метод set_page_title(). Изображения заголовка и боковой панели могут быть установлены с помощью методов set_page_header_image() и set_page_side_image().

Для добавления виджетов в рабочую область следует использовать метод add_action_widget(). Они должны быть упакованы рядом со стандартными кнопками. При этом для удаления виджетов следует использовать метод remove_action_widget().

Справочная информация

8.2.8.1. Пример

Рисунок 8-12: Помощник (Assistant)

Исходный код

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

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

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

#include "examplewindow.h"
#include "exampleassistant.h"

ExampleWindow::ExampleWindow()
: m_button("Показать помощник"),
  m_label1("Состояние кнопки-переключателя помощника:"),
  m_label2("Содержимое поля ввода строки помощника:")
{
  set_title("Пример использования класса Gtk::Assistant");
  set_border_width(12);

m_grid.set_row_homogeneous(true);

m_grid.attach(m_button, 0, 0, 2, 1);
  m_button.set_hexpand(true);
  m_button.set_valign(Gtk::ALIGN_CENTER);

m_grid.attach(m_label1, 0, 1, 1, 1);
  m_label1.set_alignment(0.0, 0.5);

m_grid.attach(m_label2, 0, 2, 1, 1);
  m_label2.set_alignment(0.0, 0.5);

m_grid.attach(m_check, 1, 1, 1, 1);
  m_check.set_halign(Gtk::ALIGN_START);

m_grid.attach(m_entry, 1, 2, 1, 1);
  m_entry.set_hexpand(true);

add(m_grid);

m_button.signal_clicked().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_button_clicked));
  m_assistant.signal_apply().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_assistant_apply));

m_check.set_sensitive(false);
  m_entry.set_sensitive(false);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_assistant_apply()
{
  bool check_state;
  Glib::ustring entry_text;

m_assistant.get_result(check_state, entry_text);
  m_check.set_active(check_state);
  m_entry.set_text(entry_text);
}

void ExampleWindow::on_button_clicked()
{
  m_assistant.show();
}

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

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

ExampleAssistant::ExampleAssistant()
: m_box(Gtk::ORIENTATION_HORIZONTAL, 12),
  m_label1("Введите строку для продолжения работы:"),
  m_label2("Страница подтверждения"),
  m_check("Дополнительная информация")
{
  set_title("Пример использования класса Gtk::Assistant");
  set_border_width(12);
  set_default_size(400, 300);

m_box.pack_start(m_label1);
  m_box.pack_start(m_entry);

append_page(m_box);
  append_page(m_check);
  append_page(m_label2);

set_page_title(*get_nth_page(0), "Страница 1");
  set_page_title(*get_nth_page(1), "Страница 2");
  set_page_title(*get_nth_page(2), "Подтверждение");

set_page_complete(m_check, true);
  set_page_complete(m_label2, true);

set_page_type(m_box, Gtk::ASSISTANT_PAGE_INTRO);
  set_page_type(m_label2, Gtk::ASSISTANT_PAGE_CONFIRM);

signal_apply().connect(sigc::mem_fun(*this,
    &ExampleAssistant::on_assistant_apply));
  signal_cancel().connect(sigc::mem_fun(*this,
    &ExampleAssistant::on_assistant_cancel));
  signal_close().connect(sigc::mem_fun(*this,
    &ExampleAssistant::on_assistant_close));
  signal_prepare().connect(sigc::mem_fun(*this,
    &ExampleAssistant::on_assistant_prepare));

m_entry.signal_changed().connect(sigc::mem_fun(*this,
    &ExampleAssistant::on_entry_changed));

show_all_children();
}

ExampleAssistant::~ExampleAssistant()
{
}

void ExampleAssistant::get_result(bool& check_state, Glib::ustring& entry_text)
{
  check_state = m_check.get_active();
  entry_text = m_entry.get_text();
}

void ExampleAssistant::on_assistant_apply()
{
  std::cout << "Кнопка \"Применить\" была нажата";
  print_status();
}

void ExampleAssistant::on_assistant_cancel()
{
  std::cout << "Кнопка \"Отменить\" была нажата";
  print_status();
  hide();
}

void ExampleAssistant::on_assistant_close()
{
  std::cout << "Помощник был закрыт";
  print_status();
  hide();
}

void ExampleAssistant::on_assistant_prepare(Gtk::Widget* /* widget */)
{
  set_title(Glib::ustring::compose("Пример использования класса Gtk::Assistant (Страница %1 из %2)",
    get_current_page() + 1, get_n_pages()));
}

void ExampleAssistant::on_entry_changed()
{
  // Эта страница является завершенной только после ввода строки в поле ввода.
  if(m_entry.get_text_length())
    set_page_complete(m_box, true);
  else
    set_page_complete(m_box, false);
}

void ExampleAssistant::print_status()
{
  std::cout << ", содержимое поля ввода строки: \"" << m_entry.get_text()
    << "\", состояние кнопки-переключателя: " << m_check.get_active() << std::endl;
}

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

Следующий раздел : Виджет древовидного представления данных (TreeView).