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

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

7. Виджеты общего назначения

7.1. Виджет вывода строки (Label)

Использование виджетов вывода строк является основным способом вывода текста в окнах, например, с целью размещения заголовка для представленного классом Gtk::Entry виджета ввода строки. Вы можете задать текст с помощью конструктора или позднее с помощью методов set_text() или set_markup().

Ширина виджета вывода строки будет установлена автоматически. Вы можете разделить выводимую строку на несколько строк, разместив символы переноса строк ("\n") в исходной строке.

Выводимый текст может выравниваться с помощью метода set_justify(). Виджет также имеет функцию переноса слов, которая активируется с помощью метода set_line_wrap().

Класс Gtk::Label поддерживает функции простого форматирования текста, к примеру, позволяя вам сделать определенный текст жирным, выделить его с помощью цвета или увеличить его размер. Вы можете выполнить описанные действия, передавая исходную строку методу set_markup() и используя синтаксис разметки Pango. Например, <b>выделенный жирным текст</b> или <s>перечеркнутый текст</s>.

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

7.1.1. Пример

Ниже приведен короткий пример, иллюстрирующий описанные функции. В этом примере используется виджет рамки для лучшей демонстрации стилей строк. (Виджет рамки описывается в разделе "Рамка (Frame)").

Рисунок 7-1: Виджеты вывода строк
Виджет вывода строки

Исходный код

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

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

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

ExampleWindow::ExampleWindow()
:
  m_HBox(Gtk::ORIENTATION_HORIZONTAL, 5),
  m_VBox(Gtk::ORIENTATION_VERTICAL, 5),
  m_VBox2(Gtk::ORIENTATION_VERTICAL, 5),
  m_Frame_Normal("Обычная строка"),
  m_Frame_Multi("Разделенная строка"),
  m_Frame_Left("Строка с выравниванием по левому краю"),
  m_Frame_Right("Строка с выравниванием по правому краю"),
  m_Frame_LineWrapped("Строка с переносом слов"),
  m_Frame_FilledWrapped("Строка с переносом слов и заполнением пространства"),
  m_Frame_Underlined("Строка с подчеркиванием"),
  m_Label_Normal("_Это обычная строка", true),
  m_Label_Multi("Эта строка разделена на несколько.\nВторая строка\nТретья строка"),
  m_Label_Left("Это строка с выравниванием по левому краю\nС разделением на несколько строк.\nТретья строка"),
  m_Label_Right("Это строка с выравниванием по правому краю\nС разделением на несколько строк.\nТретья строка"),
  m_Label_Underlined("Это строка с подчеркиванием!\n"
          "А это строка с довольно забавным подчеркиванием")
{
  set_title("Виджеты вывода строк");
  set_border_width(5);

add(m_HBox);

m_HBox.pack_start(m_VBox, Gtk::PACK_SHRINK);

m_Frame_Normal.add(m_Label_Normal);
  m_VBox.pack_start(m_Frame_Normal, Gtk::PACK_SHRINK);

m_Frame_Multi.add(m_Label_Multi);
  m_VBox.pack_start(m_Frame_Multi, Gtk::PACK_SHRINK);

m_Label_Left.set_justify(Gtk::JUSTIFY_LEFT);
  m_Frame_Left.add(m_Label_Left);
  m_VBox.pack_start(m_Frame_Left, Gtk::PACK_SHRINK);

m_Label_Right.set_justify(Gtk::JUSTIFY_RIGHT);
  m_Frame_Right.add(m_Label_Right);
  m_VBox.pack_start(m_Frame_Right, Gtk::PACK_SHRINK);

m_HBox.pack_start(m_VBox2, Gtk::PACK_SHRINK);

m_Label_LineWrapped.set_text(
          "Это пример строки с переносом слов.  Она "
          /*В следующей строке оставлен большой зазор для проверки */
          "не должна занимать всю резервируемую виджетом ширину             "
          "причем должен осуществляться автоматический перенос "
          "слов для их компактного размещения.  "
          "Настало время, когда все хорошие люди должны "
          "прийти на помощь своей партии.  "
          "Шестая овца шестого шейха больна.\n"
          "     Реализована корректная поддержка параграфов, а"
          "также  корректное   добавление "
          "множества          дополнительных  пробелов. ");
  m_Label_LineWrapped.set_line_wrap();
  m_Frame_LineWrapped.add(m_Label_LineWrapped);
  m_VBox2.pack_start(m_Frame_LineWrapped, Gtk::PACK_SHRINK);

m_Label_FilledWrapped.set_text(
          "Это пример строки с переносом слов и заполнением.  "
          "Она должна занять "
          "все              зарезервированное для нее место.  "
          "Это предложение подтверждает "
          "мое утверждение.  А это еще одно предложение. "
          "Солнце встает, до де до де до.\n"
          "   Это новый параграф.\n"
          "   Это еще один более новый, более длинный, лучший "
          "параграф.  Он заканчивается, "
          "к сожалению.");
  m_Label_FilledWrapped.set_justify(Gtk::JUSTIFY_FILL);
  m_Label_FilledWrapped.set_line_wrap();
  m_Frame_FilledWrapped.add(m_Label_FilledWrapped);
  m_VBox2.pack_start(m_Frame_FilledWrapped, Gtk::PACK_SHRINK);

m_Label_Underlined.set_justify(Gtk::JUSTIFY_LEFT);
  m_Label_Underlined.set_pattern (
          "____________________________ _ _________ _ ______"
          "     __ _______ ___");
  m_Frame_Underlined.add(m_Label_Underlined);
  m_VBox2.pack_start(m_Frame_Underlined, Gtk::PACK_SHRINK);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

7.2. Виджет ввода строки (Entry)

7.2.1. Стандартные приемы работы

Виджеты ввода строк позволяют пользователю вводить текст. Вы можете изменить содержимое поля ввода виджета с помощью метода set_text(), а также получить его текущее содержимое с помощью метода get_text().

Иногда вам может понадобиться сделать текст в поле ввода виджета доступным только для чтения. Эта задача может быть решена путем передачи логического значения false в качестве параметра метода set_editable().

В случае ввода пролей, кодовых фраз и другой информации, которую вам не хотелось бы отображать на экране, для скрытия текста в поле ввода виджета может использоваться вызов метода set_visibility() с передачей логического значения false в качестве параметра.

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

В том случае, если при вызове метода set_activates_default() вы передадите логическое значение true в качестве параметра, нажатие кнопки Enter в поле ввода представленного классом Gtk::Entry виджета ввода строки приведет к активации стандартного виджета окна, содержащего этот виджет ввода строки. Это особенно полезно при создании окон диалогов. Стандартным виджетом в подобных случаях обычно является одна из кнопок диалога, которая, например, приводит к закрытию окна диалога. Для того, чтобы сделать виджет стандартным виджетом окна, следует использовать методы Gtk::Widget::set_default() и Gtk::Widget::grab_default().

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

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

Этот пример иллюстрирует метод использования класса Gtk::Entry. Также в нем используются два флажка, с помощью которых вы можете устанавливать возможность редактирования строки и видимость введенных символов.

Рисунок 7-2: Пример использования виджета ввода строки

Исходный код

Файл 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_Button_Close("Закрыть"),
  m_CheckButton_Editable("Строка редактируется"),
  m_CheckButton_Visible("Строка видима")
{
  set_size_request(200, 100);
  set_title("Пример использования класса Gtk::Entry");

add(m_VBox);

m_Entry.set_max_length(50);
  m_Entry.set_text("hello");
  m_Entry.set_text(m_Entry.get_text() + " world");
  m_Entry.select_region(0, m_Entry.get_text_length());
  m_VBox.pack_start(m_Entry);

// Учтите, что вы также можете использовать метод add() вместо pack_xxx()
  m_VBox.add(m_HBox);

m_HBox.pack_start(m_CheckButton_Editable);
  m_CheckButton_Editable.signal_toggled().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_checkbox_editable_toggled) );
  m_CheckButton_Editable.set_active(true);

m_HBox.pack_start(m_CheckButton_Visible);
  m_CheckButton_Visible.signal_toggled().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_checkbox_visibility_toggled) );
  m_CheckButton_Visible.set_active(true);

m_Button_Close.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_button_close) );
  m_VBox.pack_start(m_Button_Close);
  m_Button_Close.set_can_default();
  m_Button_Close.grab_default();

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_checkbox_editable_toggled()
{
  m_Entry.set_editable(m_CheckButton_Editable.get_active());
}

void ExampleWindow::on_checkbox_visibility_toggled()
{
  m_Entry.set_visibility(m_CheckButton_Visible.get_active());
}

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

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

7.2.2. Автоматическое завершение ввода

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

Для активации этих функций вы должны создать объект завершения ввода на основе класса Gtk::EntryCompletion и передать его виджету ввода строки с помощью метода set_completion().

Объект Gtk::EntryCompletion может использовать содержащую возможные варианты ввода модель древовидной структуры, реализованную в рамках класса Gtk::TreeModel и передаваемую объекту виджета с помощью метода set_model(). После этого вы должны вызвать метод set_text_column() для указания того, какой из столбцов вашей модели должен использоваться для подбора возможных вариантов текстового ввода.

Альтернативным решением, применяемым вместо списка вариантов ввода в том случае, если полный список возможных вариантов ввода является очень большим и сложным для генерации, является использование функции обратного вызова, передаваемой с помощью метода set_match_func(). Этот подход также полезен в том случае, если вы хотите производить поиск на основе произвольного фрагмента строки вместо ее первых символов.

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

7.2.2.1. Пример автоматического завершения ввода

В данном примере на основе класса Gtk::EntryCompletion создается объект, который ассоциируется с виджетом, представленным классом Gtk::Entry. Для завершения ввода используется реализованная в рамках класса Gtk::TreeModel модель древовидной структуры с возможными вариантами ввода, а также некоторые дополнительные действия.

Рисунок 7-3: Пример автоматического завершения ввода

Исходный код

Файл 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_close();

void on_completion_action_activated(int index);

//Обратите внимание на комментарий в коде реализации:
  //bool on_completion_match(const Glib::ustring& key, const Gtk::TreeModel::const_iterator& iter);

//Столбцы модели древовидной структуры для фильтрации вариантов строкового ввода:
  class ModelColumns : public Gtk::TreeModel::ColumnRecord
  {
  public:

ModelColumns()
    { add(m_col_id); add(m_col_name); }

Gtk::TreeModelColumn<unsigned int> m_col_id;
    Gtk::TreeModelColumn<Glib::ustring> m_col_name;
  };

ModelColumns m_Columns;

typedef std::map<int, Glib::ustring> type_actions_map;
  type_actions_map m_CompletionActions;
  
  //Дочерние виджеты:
  Gtk::Box m_HBox;
  Gtk::Box m_VBox;
  Gtk::Entry m_Entry;
  Gtk::Label m_Label;
  Gtk::Button m_Button_Close;
};

#endif //GTKMM_EXAMPLEWINDOW_H

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

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

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_Label("Нажмите a или b для вывода вариантов завершения строки и действий."),
  m_Button_Close("Закрыть")
{
  //set_size_request(200, 100);
  set_title("Пример использования класса Gtk::EntryCompletion");

add(m_VBox);
  m_VBox.pack_start(m_Entry, Gtk::PACK_SHRINK);

m_VBox.pack_start(m_Label, Gtk::PACK_EXPAND_WIDGET);

m_Button_Close.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_button_close) );
  m_VBox.pack_start(m_Button_Close, Gtk::PACK_SHRINK);
  m_Button_Close.set_can_default();
  m_Button_Close.grab_default();

//Создание объекта завершения ввода EntryCompletion:
  Glib::RefPtr<Gtk::EntryCompletion> completion =
      Gtk::EntryCompletion::create();
  m_Entry.set_completion(completion);

//Создание и заполнение модели фильтра объекта завершения ввода
  Glib::RefPtr<Gtk::ListStore> refCompletionModel =
      Gtk::ListStore::create(m_Columns);
  completion->set_model(refCompletionModel);

// Для более сложных вариантов завершения ввода следует использовать аналогичную 
  // следующей функцию обратного вызова, предназначенную для подбора вариантов.
  // Обратите внимание на комментарий с подробностями реализации, расположенный ниже:
  //completion->set_match_func( sigc::mem_fun(*this,
              //&ExampleWindow::on_completion_match) );

//Заполнение модели древовидного представления
  Gtk::TreeModel::Row row = *(refCompletionModel->append());
  row[m_Columns.m_col_id] = 1;
  row[m_Columns.m_col_name] = "Alan Zebedee";

row = *(refCompletionModel->append());
  row[m_Columns.m_col_id] = 2;
  row[m_Columns.m_col_name] = "Adrian Boo";

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

row = *(refCompletionModel->append());
  row[m_Columns.m_col_id] = 4;
  row[m_Columns.m_col_name] = "Bob McBob";

//Установление столбца модели, который должен использоваться для:
  //- поиска варианта ввода (тогда, когда мы используем стандартный механизм вместо
  //  функции обратного вызова set_match_func().
  //- показа текста в поле ввода виджета в случае нахождения подходящего варианта.
  completion->set_text_column(m_Columns.m_col_name);

//Добавление действий к механизму завершения ввода:
  //Это просто дополнительные пункты, выводимые снизу списка возможных
  //вариантов завершения ввода.

//Сохранение их на будущее.
  m_CompletionActions[0] = "Использовать помощник";
  m_CompletionActions[1] = "Найти файл";

for(type_actions_map::iterator iter = m_CompletionActions.begin();
          iter != m_CompletionActions.end(); ++iter)
  {
    int position = iter->first;
    Glib::ustring title = iter->second;
    completion->insert_action_text(title, position);
  }

completion->signal_action_activated().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_completion_action_activated) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

/* Вы можете осуществлять более сложные операции подбора вариантов завершения ввода с помощью подобных обработчиков.
 * Например, вы можете искать подстроки в строке вместо сравнения начальных символов
 * или же вы можете искать ключ в дополнительных столбцах модели наряду со столбцом модели, который используется для вывода.
 * Данный код на самом деле не намного сложнее - это повторная реализация стандартного механизма.
 *
bool ExampleWindow::on_completion_match(const Glib::ustring& key, const
        Gtk::TreeModel::const_iterator& iter)
{
  if(iter)
  {
    Gtk::TreeModel::Row row = *iter;

Glib::ustring::size_type key_length = key.size();
    Glib::ustring filter_string = row[m_Columns.m_col_name];

Glib::ustring filter_string_start = filter_string.substr(0, key_length);
    //Ключ записывается в нижнем регистре даже тогда, когда регистр пользовательского ввода не соответствует ему.
    filter_string_start = filter_string_start.lowercase();

if(key == filter_string_start)
      return true; //Совпадение найдено.
  }

return false; //Нет совпадений.
}
*/

void ExampleWindow::on_completion_action_activated(int index)
{
  type_actions_map::iterator iter = m_CompletionActions.find(index);
  if(iter != m_CompletionActions.end()) //Если действие существует
  {
    Glib::ustring title = iter->second;
    std::cout << "Выбрано действие: " << title << std::endl;
  }
}

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

7.2.3. Иконки в поле ввода

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

Рисунок 7-4: Виджет ввода строки с иконкой

Исходный код

Файл 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_Button_Close("Закрыть")
{
  set_title("Пример использования класса Gtk::Entry");

add(m_VBox);

m_Entry.set_max_length(50);
  m_Entry.set_text("Hello world");
  m_VBox.pack_start(m_Entry, Gtk::PACK_SHRINK);

m_Entry.set_icon_from_icon_name("edit-find");
  m_Entry.signal_icon_press().connect( sigc::mem_fun(*this, &ExampleWindow::on_icon_pressed) );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_icon_pressed(Gtk::EntryIconPosition /* icon_pos */, const GdkEventButton* /* event */)
{
  std::cout << "Осуществлено нажатие на иконку." << std::endl;
}

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

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

7.2.4. Индикатор выполнения задачи в поле ввода

Виджет ввода строки может показывать индикатор выполнения задачи в поле ввода под введенным текстом. Этот индикатор выполнения задачи будет показан в том случае, если вызван метод set_progress_fraction() или set_progress_pulse_step().

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

В данном примере показан представленный классом Gtk:Entry виджет ввода строки с индикатором выполнения задачи.

Рисунок 7-5: Виджет ввода строки с индикатором выполнения задачи

Исходный код

Файл 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_Button_Close("Закрыть")
{
  set_title("Пример использования класса Gtk::Entry");

add(m_VBox);

m_Entry.set_max_length(50);
  m_Entry.set_text("Hello world");
  m_VBox.pack_start(m_Entry, Gtk::PACK_SHRINK);

//Изменять степень выполнения задачи каждую 0.1 секунды:
  Glib::signal_timeout().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_timeout), 
    100
  );

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

bool ExampleWindow::on_timeout()
{
  static double fraction = 0;
  m_Entry.set_progress_fraction(fraction);

fraction += 0.01;
  if(fraction > 1)
    fraction = 0;

return true;
}

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

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

Следующий раздел : 7.3. Виджет изменения числового значения (SpinButton).