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

Библиотека сайта 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
Дата публикации: 15 Октября 2013 г.
Перевод: А.Панин
Дата перевода: 15 марта 2014 г.

Диалоги используются в качестве вспомогательных окон для вывода специфической информации или для постановки вопросов. Окна на основе класса Gtk::Dialog содержат несколько предварительно упакованных виджетов для достижения однообразия диалогов в системе и используют метод run(), который блокируется до того момента, когда пользователь завершает взаимодействие с диалогом.

Существует несколько дочерних классов диалогов, которые могут пригодиться вам. Класс Gtk::MessageDialog используется для создания самых простых уведомлений. Но в некоторых случаях вы можете испытать потребность в создании дочернего класса вашего диалога для реализации более сложных функций.

Для упаковки виджетов в рамках диалога специального типа вы должны помещать их в контейнер на основе класса Gtk::Box, который может быть получен с помощью метода get_dialog_area(). Для простого добавления кнопки в нижнюю часть диалога вам следует использовать метод add_button().

Метод run() возвращает целочисленное значение типа int. Это может быть либо значение типа Gtk::ResponseType в том случае, если пользователь закрыл диалог путем нажатия на стандартную кнопку, либо нестандартное значение, которое может быть задано вами при использовании метода add_button().

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

16.1. Диалог с сообщением (MessageDialog)

Класс диалога с сообщением (Gtk::MessageDialog) является специальным классом для создания простых, стандартизированных диалогов с сообщением, иконкой и кнопками для взаимодействия с пользователем. Вы можете задать тип сообщения и текст при использовании конструктора, а также указать стандартные кнопки с помощью энумератора Gtk::ButtonsType.

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

16.1.1. Пример

Рисунок 16-1: Диалог с сообщением (MessageDialog)

Исходный код

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

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

#include "examplewindow.h"
#include <gtkmm/messagedialog.h>
#include <iostream>

ExampleWindow::ExampleWindow()
: m_ButtonBox(Gtk::ORIENTATION_VERTICAL),
  m_Button_Info("Показать информационное сообщение"),
  m_Button_Question("Показать сообщение с вопросом")
{
  set_title("Пример использования класса Gtk::MessageDialog");

add(m_ButtonBox);

m_ButtonBox.pack_start(m_Button_Info);
  m_Button_Info.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_info_clicked) );

m_ButtonBox.pack_start(m_Button_Question);
  m_Button_Question.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_question_clicked) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_button_info_clicked()
{
  Gtk::MessageDialog dialog(*this, "Это ИНФОРМАЦИОННОЕ сообщение");
  dialog.set_secondary_text(
          "А это вторая строка с пояснениями по поводу наступившего события.");

dialog.run();
}

void ExampleWindow::on_button_question_clicked()
{
  Gtk::MessageDialog dialog(*this, "Это сообщение с ВОПРОСОМ",
          false /* use_markup */, Gtk::MESSAGE_QUESTION,
          Gtk::BUTTONS_OK_CANCEL);
  dialog.set_secondary_text(
          "А это вторая строка с пояснениями по поводу наступившего события.");

int result = dialog.run();

//Обработка результата взаимодействия с пользователем:
  switch(result)
  {
    case(Gtk::RESPONSE_OK):
    {
      std::cout << "Нажата кнопка \"OK\"." << std::endl;
      break;
    }
    case(Gtk::RESPONSE_CANCEL):
    {
      std::cout << "Нажата кнопка \"Отмена\"." << std::endl;
      break;
    }
    default:
    {
      std::cout << "Нажата неизвестная кнопка." << std::endl;
      break;
    }
  }
}

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

16.2. Диалог выбора файлов (FileChooserDialog)

Диалог выбора файлов (реализованный в рамках класса Gtk::FileChooserDialog) подходит для реализации функций элементов меню "Открыть" или "Сохранить".

Большинство полезных методов данного класса на самом деле реализовано в рамках базового класса Gtk::FileChooser.

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

16.2.1. Пример

Рисунок 16-2: Диалог выбора файлов (FileChooser)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_ButtonBox(Gtk::ORIENTATION_VERTICAL),
  m_Button_File("Выбор файла"),
  m_Button_Folder("Выбор директории")
{
  set_title("Пример использования класса Gtk::FileSelection");

add(m_ButtonBox);

m_ButtonBox.pack_start(m_Button_File);
  m_Button_File.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_file_clicked) );

m_ButtonBox.pack_start(m_Button_Folder);
  m_Button_Folder.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_folder_clicked) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_button_folder_clicked()
{
  Gtk::FileChooserDialog dialog("Пожалуйста выберите директорию",
          Gtk::FILE_CHOOSER_ACTION_SELECT_FOLDER);
  dialog.set_transient_for(*this);

//Добавление кнопок в диалог:
  dialog.add_button("_Отмена", Gtk::RESPONSE_CANCEL);
  dialog.add_button("Выбрать", Gtk::RESPONSE_OK);

int result = dialog.run();

//Обработка результата взаимодействия с пользователем:
  switch(result)
  {
    case(Gtk::RESPONSE_OK):
    {
      std::cout << "Была нажата кнопка \"Выбрать\"." << std::endl;
      std::cout << "Выбранная директория: " << dialog.get_filename()
          << std::endl;
      break;
    }
    case(Gtk::RESPONSE_CANCEL):
    {
      std::cout << "Была нажата кнопка \"Отмена\"." << std::endl;
      break;
    }
    default:
    {
      std::cout << "Была нажата неизвестная кнопка." << std::endl;
      break;
    }
  }
}

void ExampleWindow::on_button_file_clicked()
{
  Gtk::FileChooserDialog dialog("Пожалуйста выберите файл",
          Gtk::FILE_CHOOSER_ACTION_OPEN);
  dialog.set_transient_for(*this);

//Добавление кнопок в диалог:
  dialog.add_button("_Отмена", Gtk::RESPONSE_CANCEL);
  dialog.add_button("_Открыть", Gtk::RESPONSE_OK);

//Добавление фильтров для того, чтобы можно было выбрать только определенные типы файлов:

Glib::RefPtr<Gtk::FileFilter> filter_text = Gtk::FileFilter::create();
  filter_text->set_name("Текстовые файлы");
  filter_text->add_mime_type("text/plain");
  dialog.add_filter(filter_text);

Glib::RefPtr<Gtk::FileFilter> filter_cpp = Gtk::FileFilter::create();
  filter_cpp->set_name("Файлы исходного кода для языка C/C++");
  filter_cpp->add_mime_type("text/x-c");
  filter_cpp->add_mime_type("text/x-c++");
  filter_cpp->add_mime_type("text/x-c-header");
  dialog.add_filter(filter_cpp);

Glib::RefPtr<Gtk::FileFilter> filter_any = Gtk::FileFilter::create();
  filter_any->set_name("Любые файлы");
  filter_any->add_pattern("*");
  dialog.add_filter(filter_any);

//Показ диалога и ожидание реакции пользователя:
  int result = dialog.run();

//Обработка результата взаимодействия с пользователем:
  switch(result)
  {
    case(Gtk::RESPONSE_OK):
    {
      std::cout << "Нажата кнопка \"Открыть\"." << std::endl;

//Обратите внимание на то, что используется строка типа std::string, а не Glib::ustring.
      std::string filename = dialog.get_filename();
      std::cout << "Выбранный файл: " <<  filename << std::endl;
      break;
    }
    case(Gtk::RESPONSE_CANCEL):
    {
      std::cout << "Нажата кнопка \"Отменить\"." << std::endl;
      break;
    }
    default:
    {
      std::cout << "Нажата неизвестная кнопка." << std::endl;
      break;
    }
  }
}

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

16.3. Диалог выбора цвета (ColorChooserDialog)

Диалог выбора цвета (представленный классом Gtk::ColorChooserDialog) позволяет пользователю выбрать цвет. Виджет кнопки выбора цвета (представленный классом Gtk::ColorButton) позволяет открыть диалог выбора цвета при нажатии.

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

16.3.1. Пример

Рисунок 16-3: Диалог выбора цвета (ColorChooserDialog)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL, 5),
  m_Button_Dialog("Выбрать цвет")
{
  set_title("Пример использования класса Gtk::ColorChooserDialog");
  set_default_size(200, 200);

add(m_VBox);

m_VBox.pack_start(m_ColorButton, Gtk::PACK_SHRINK);
  m_ColorButton.signal_color_set().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_color_button_color_set) );

m_VBox.pack_start(m_Button_Dialog, Gtk::PACK_SHRINK);
  m_Button_Dialog.signal_clicked().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_button_dialog_clicked) );

//Установка начального цвета:
  m_Color.set_red(0.0);
  m_Color.set_green(0.0);
  m_Color.set_blue(1.0);
  m_Color.set_alpha(1.0); //непрозрачный
  m_ColorButton.set_rgba(m_Color);

m_DrawingArea.override_background_color(m_Color);

m_VBox.pack_start(m_DrawingArea);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_color_button_color_set()
{
  //Сохранение выбранного цвета и его демонстрация:
  m_Color = m_ColorButton.get_rgba();
  m_DrawingArea.override_background_color(m_Color);
}

void ExampleWindow::on_button_dialog_clicked()
{
  Gtk::ColorChooserDialog dialog("Пожалуйста выберите цвет");
  dialog.set_transient_for(*this);

//Получение ранее выбранного цвета:
  dialog.set_rgba(m_Color);

const int result = dialog.run();

//Обработка результата взаимодействия с пользователем:
  switch(result)
  {
    case Gtk::RESPONSE_OK:
    {
      //Сохранение выбранного цвета и его демонстрация:
      m_Color = dialog.get_rgba();
      m_ColorButton.set_rgba(m_Color);
      m_DrawingArea.override_background_color(m_Color);
      break;
    }
    case Gtk::RESPONSE_CANCEL:
    {
      std::cout << "Нажата кнопка \"Отменить\"." << std::endl;
      break;
    }
    default:
    {
      std::cout << "Нажата неизвестная кнопка: " << result << std::endl;
      break;
    }
  }
}

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

16.4. Диалог выбора шрифта (FontChooserDialog)

Диалог выбора шрифта (представленный классом Gtk::FontChooserDialog) позволяет пользователю выбрать шрифт. Виджет кнопки выбора шрифта (представленный классом Gtk::FontButton) открывает диалог выбора шрифта при нажатии.

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

16.4.1. Пример

Рисунок 16-4: Диалог выбора шрифта (FontChooserDialog)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_ButtonBox(Gtk::ORIENTATION_VERTICAL),
  m_FontButton("Sans 10"),
  m_Button_Dialog("Выбор шрифта")
{
  set_title("Пример использования класса Gtk::FontChooserDialog");

add(m_ButtonBox);

m_ButtonBox.pack_start(m_FontButton);
  m_FontButton.set_use_font(true);
  m_FontButton.set_use_size(true);
  m_FontButton.signal_font_set().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_font_button_font_set) );

m_ButtonBox.pack_start(m_Button_Dialog);
  m_Button_Dialog.signal_clicked().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_button_dialog_clicked) );
  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_font_button_font_set()
{
  Glib::ustring font_name = m_FontButton.get_font_name();
  std::cout << "Выбранный шрифт: " << font_name << std::endl;
}

void ExampleWindow::on_button_dialog_clicked()
{
  Gtk::FontChooserDialog dialog("Пожалуйста выберите шрифт", *this);

//Получение ранее выбранного шрифта от объекта кнопки выбора шрифта:
  dialog.set_font(m_FontButton.get_font_name());

int result = dialog.run();

//Обработка результата взаимодействия с пользователем:
  switch(result)
  {
    case Gtk::RESPONSE_OK:
    {
      Glib::ustring font_name = dialog.get_font();
      std::cout << "Выбранный шрифт: " << font_name << std::endl;
      m_FontButton.set_font_name(font_name);
      break;
    }
    case Gtk::RESPONSE_CANCEL:
    {
      std::cout << "Нажата кнопка \"Отмена\"." << std::endl;
      break;
    }
    default:
    {
      std::cout << "Нажата неизвестная кнопка: " << result << std::endl;
      break;
    }
  }
}

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

16.5. Немодальный диалог с информацией о программе (AboutDialog)

Диалог с информацией о программе (представленный классом Gtk::AboutDialog) позволяет упростить вывод такой информации о программе, как ее логотип, название, список авторов, вебсайт и текст лицензии.

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

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

16.5.1. Пример

Рисунок 16-5: Диалог с информацией о программе (AboutDialog)

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Label("Диалог с информацией о программе является немодальным."
    "Вы можете выделять этот текст во время показа диалога с информацией о программе."),
  m_ButtonBox(Gtk::ORIENTATION_VERTICAL),
  m_Button("Показать диалог с информацией о программе")
{
  set_title("Пример использования класса Gtk::AboutDialog");

add(m_VBox);

m_VBox.pack_start(m_Label);
  m_Label.set_line_wrap(true);
  m_Label.set_selectable(true);

m_VBox.pack_start(m_ButtonBox);
  m_ButtonBox.pack_start(m_Button);
  m_Button.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_clicked) );

m_Dialog.set_transient_for(*this);

m_Dialog.set_program_name("Пример приложения");
  m_Dialog.set_version("1.0.0");
  m_Dialog.set_copyright("Murray Cumming");
  m_Dialog.set_comments("Это всего лишь пример приложения.");
  m_Dialog.set_license("LGPL");

m_Dialog.set_website("http://www.gtkmm.org");
  m_Dialog.set_website_label("Вебсайт gtkmm");

std::vector<Glib::ustring> list_authors;
  list_authors.push_back("Murray Cumming");
  list_authors.push_back("Кто-то еще");
  list_authors.push_back("И другие");
  m_Dialog.set_authors(list_authors);

m_Dialog.signal_response().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_about_dialog_response) );

show_all_children();

// Виджет должен быть прорисован и показан перед вызовом метода grab_focus().
  // Именно поэтому данный вызов метода осуществляется после вызова метода  show_all_children().
  m_Button.grab_focus();
}

ExampleWindow::~ExampleWindow()
{
 
}

void ExampleWindow::on_about_dialog_response(int response_id)
{
  std::cout << response_id
    << ", \"Закрыть\"=" << Gtk::RESPONSE_CLOSE
    << ", \"Отмена\"=" << Gtk::RESPONSE_CANCEL
    << ", Закрытие окна (delete_event)=" << Gtk::RESPONSE_DELETE_EVENT
    << std::endl;

if((response_id == Gtk::RESPONSE_CLOSE) ||
     (response_id == Gtk::RESPONSE_CANCEL) )
  {
    m_Dialog.hide();
  }
}

void ExampleWindow::on_button_clicked()
{
  m_Dialog.show();

//Перемещение окна на передний план в том случае, если оно уже показано:
  m_Dialog.present();
}

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

Следующий раздел : 17. Виджет области рисования.