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

Библиотека сайта 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.3. Виджет изменения числового значения (SpinButton)

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

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

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

value (значение): текущее значение, выбранное виджетом изменения числового значения
lower (минимум): минимальное значение диапазона
upper (максимум): максимальное значение диапазона
step_increment (приращение шага): значение, которое будет прибавляться к текущему числовому значению или вычитаться из него при нажатии на кнопку виджета с помощью первой кнопки мыши
page_increment (приращение страницы): значение, которое будет прибавляться к текущему числовому значению или вычитаться из него при нажатии на кнопку виджета с помощью второй кнопки мыши
page_size (размер страницы): не используется

Дополнительно третья кнопка мыши может использоваться для непосредственной установки максимального (upper) или минимального (lower) числового значения.

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

7.3.1. Методы

Количество десятичных разрядов может быть изменено с помощью метода set_digits().

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

Метод spin() "прокручивает" значение виджета выбора числового значения таким же образом, как это делается при нажатии на одну из кнопок виджета. Вы должны использовать параметр типа Gtk::SpinType для указания направления изменения значения или нового значения.

Для предотвращения непосредственного ввода пользователем символов, не относящихся к числам, следует передать логическое значение true при вызове метода set_numeric().

Для активации "перевода" значения виджета изменения числовых значений между минимальным и максимальным значением следует использовать метод set_wrap().

Для принудительной привязки числового значения к текущему значению приращения шага (step_increment) следует использовать метод set_snap_to_ticks().

Вы можете изменить политику обновления значения виджета с помощью метода set_upadate_policy(), используя либо значение Gtk::UPDATE_ALWAYS, либо значение Gtk::UPDATE_IF_VALID. Параметр Gtk::UPDATE_ALWAYS позволяет виджету изменения числового значения игнорировать ошибки, которые произошли в процессе преобразования текста из поля ввода в числовое значение. Таким образом, эта установка позволяет использовать не относящиеся к числовым значения при работе с виджетом изменения числового значения. Вы можете провести принудительное немедленное обновление значения виджета с помощью метода update().

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

7.3.2. Пример

Ниже приведен пример работы с виджетом изменения числового значения:

Рисунок 7-6: Виджет изменения числового значения

Исходный код

Файл 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_checkbutton_snap();
  void on_checkbutton_numeric();
  void on_spinbutton_digits_changed();
  void on_button_close();

enum enumValueFormats
  {
    VALUE_FORMAT_INT,
    VALUE_FORMAT_FLOAT
  };
  void on_button_getvalue(enumValueFormats display);

//Дочерние виджеты:
  Gtk::Frame m_Frame_NotAccelerated, m_Frame_Accelerated;
  Gtk::Box m_HBox_NotAccelerated, m_HBox_Accelerated,
    m_HBox_Buttons;
  Gtk::Box m_VBox_Main, m_VBox, m_VBox_Day, m_VBox_Month, m_VBox_Year,
    m_VBox_Accelerated, m_VBox_Value, m_VBox_Digits;
  Gtk::Label m_Label_Day, m_Label_Month, m_Label_Year,
    m_Label_Value, m_Label_Digits,
    m_Label_ShowValue;
  Glib::RefPtr<Gtk::Adjustment> m_adjustment_day, m_adjustment_month, m_adjustment_year,
    m_adjustment_value, m_adjustment_digits;
  Gtk::SpinButton m_SpinButton_Day, m_SpinButton_Month, m_SpinButton_Year,
    m_SpinButton_Value, m_SpinButton_Digits;
  Gtk::CheckButton m_CheckButton_Snap, m_CheckButton_Numeric;
  Gtk::Button m_Button_Int, m_Button_Float, m_Button_Close;
};

#endif //GTKMM_EXAMPLEWINDOW_H

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

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

ExampleWindow::ExampleWindow()
:
  m_Frame_NotAccelerated("С неизменяемыми параметрами"),
  m_Frame_Accelerated("С изменяемыми параметрами"),
  m_VBox_Main(Gtk::ORIENTATION_VERTICAL, 5),
  m_VBox(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Day(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Month(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Year(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Accelerated(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Value(Gtk::ORIENTATION_VERTICAL),
  m_VBox_Digits(Gtk::ORIENTATION_VERTICAL),
  m_Label_Day("День: "),
  m_Label_Month("Месяц: "),
  m_Label_Year("Год: "),
  m_Label_Value("Значение: "),
  m_Label_Digits("Разряды: "),
  m_adjustment_day( Gtk::Adjustment::create(1.0, 1.0, 31.0, 1.0, 5.0, 0.0) ),
  m_adjustment_month( Gtk::Adjustment::create(1.0, 1.0, 12.0, 1.0, 5.0, 0.0) ),
  m_adjustment_year( Gtk::Adjustment::create(2012.0, 1.0, 2200.0, 1.0, 100.0, 0.0) ),
  m_adjustment_value( Gtk::Adjustment::create(0.0, -10000.0, 10000.0, 0.5, 100.0, 0.0) ),
  m_adjustment_digits( Gtk::Adjustment::create(2.0, 1.0, 5.0, 1.0, 1.0, 0.0) ),
  m_SpinButton_Day(m_adjustment_day),
  m_SpinButton_Month(m_adjustment_month),
  m_SpinButton_Year(m_adjustment_year),
  m_SpinButton_Value(m_adjustment_value, 1.0, 2),
  m_SpinButton_Digits(m_adjustment_digits),
  m_CheckButton_Snap("Округление до 0.5"),
  m_CheckButton_Numeric("Режим ввода числовых значений"),
  m_Button_Int("Целочисленное значение"),
  m_Button_Float("Значение с плавающей точкой"),
  m_Button_Close("Закрыть")
{
  set_title("Виджет изменения числового значения");

m_VBox_Main.set_border_width(10);
  add(m_VBox_Main);

m_VBox_Main.pack_start(m_Frame_NotAccelerated);

m_VBox.set_border_width(5);
  m_Frame_NotAccelerated.add(m_VBox);

/* Виджеты выбора дня, месяца, года */

m_VBox.pack_start(m_HBox_NotAccelerated, Gtk::PACK_EXPAND_WIDGET, 5);

m_Label_Day.set_alignment(Gtk::ALIGN_START);
  m_VBox_Day.pack_start(m_Label_Day);

m_SpinButton_Day.set_wrap();

m_VBox_Day.pack_start(m_SpinButton_Day);

m_HBox_NotAccelerated.pack_start(m_VBox_Day, Gtk::PACK_EXPAND_WIDGET, 5);

m_Label_Month.set_alignment(Gtk::ALIGN_START);
  m_VBox_Month.pack_start(m_Label_Month);

m_SpinButton_Month.set_wrap();
  m_VBox_Month.pack_start(m_SpinButton_Month);

m_HBox_NotAccelerated.pack_start(m_VBox_Month, Gtk::PACK_EXPAND_WIDGET, 5);

m_Label_Year.set_alignment(Gtk::ALIGN_START);
  m_VBox_Year.pack_start(m_Label_Year);

m_SpinButton_Year.set_wrap();
  m_SpinButton_Year.set_size_request(55, -1);
  m_VBox_Year.pack_start(m_SpinButton_Year);

m_HBox_NotAccelerated.pack_start(m_VBox_Year, Gtk::PACK_EXPAND_WIDGET, 5);

//С изменяемыми параметрами:
  m_VBox_Main.pack_start(m_Frame_Accelerated);

m_VBox_Accelerated.set_border_width(5);
  m_Frame_Accelerated.add(m_VBox_Accelerated);

m_VBox_Accelerated.pack_start(m_HBox_Accelerated, Gtk::PACK_EXPAND_WIDGET, 5);

m_HBox_Accelerated.pack_start(m_VBox_Value, Gtk::PACK_EXPAND_WIDGET, 5);

m_Label_Value.set_alignment(Gtk::ALIGN_START);
  m_VBox_Value.pack_start(m_Label_Value);

m_SpinButton_Value.set_wrap();
  m_SpinButton_Value.set_size_request(100, -1);
  m_VBox_Value.pack_start(m_SpinButton_Value);

m_HBox_Accelerated.pack_start(m_VBox_Digits, Gtk::PACK_EXPAND_WIDGET, 5);

m_Label_Digits.set_alignment(Gtk::ALIGN_START);
  m_VBox_Digits.pack_start(m_Label_Digits);

m_SpinButton_Digits.set_wrap();
  m_adjustment_digits->signal_value_changed().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_spinbutton_digits_changed) );

m_VBox_Digits.pack_start(m_SpinButton_Digits);

//Флажки:
  m_VBox_Accelerated.pack_start(m_CheckButton_Snap);
  m_CheckButton_Snap.set_active();
  m_CheckButton_Snap.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_checkbutton_snap) );

m_VBox_Accelerated.pack_start(m_CheckButton_Numeric);
  m_CheckButton_Numeric.set_active();
  m_CheckButton_Numeric.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_checkbutton_numeric) );

//Кнопки:
  m_VBox_Accelerated.pack_start (m_HBox_Buttons, Gtk::PACK_SHRINK, 5);

m_Button_Int.signal_clicked().connect( sigc::bind( sigc::mem_fun(*this,
                  &ExampleWindow::on_button_getvalue), VALUE_FORMAT_INT) );
  m_HBox_Buttons.pack_start(m_Button_Int, Gtk::PACK_EXPAND_WIDGET, 5);

m_Button_Float.signal_clicked().connect( sigc::bind( sigc::mem_fun(*this,
                  &ExampleWindow::on_button_getvalue), VALUE_FORMAT_FLOAT) );
  m_HBox_Buttons.pack_start(m_Button_Float, Gtk::PACK_EXPAND_WIDGET, 5);

m_VBox_Accelerated.pack_start(m_Label_ShowValue);
  m_Label_ShowValue.set_text("0");

//Кнопка закрытия:
  m_Button_Close.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_button_close) );
  m_VBox_Main.pack_start(m_Button_Close, Gtk::PACK_SHRINK);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

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

void ExampleWindow::on_checkbutton_snap()
{
  m_SpinButton_Value.set_snap_to_ticks( m_CheckButton_Snap.get_active() );
}

void ExampleWindow::on_checkbutton_numeric()
{
  m_SpinButton_Value.set_numeric( m_CheckButton_Numeric.get_active() );
}

void ExampleWindow::on_spinbutton_digits_changed()
{
  m_SpinButton_Value.set_digits( m_SpinButton_Digits.get_value_as_int() );
}

void ExampleWindow::on_button_getvalue(enumValueFormats display)
{
  gchar buf[32];

if (display == VALUE_FORMAT_INT)
    sprintf (buf, "%d", m_SpinButton_Value.get_value_as_int());
  else
    sprintf (buf, "%0.*f", m_SpinButton_Value.get_digits(),
            m_SpinButton_Value.get_value());

m_Label_ShowValue.set_text(buf);
}

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

7.4. Индикатор выполнения задачи (ProgressBar)

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

Для изменения демонстрируемого значения следует использовать метод set_fraction() с передачей значения с плавающей точкой в диапазоне от 0 до 1, являющегося текущей степенью выполнения операции в процентах.

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

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

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

7.4.1. Режим активности

Помимо демонстрации степени выполнения задачи, индикатор выполнения задачи также может использоваться для демонстрации того, что приложение активно; для этого индикатор выполнения задачи переводится в режим активности (activity mode). В этом режиме индикатор выполнения задачи выводит небольшой прямоугольник, который движется из стороны в сторону. Режим активности наиболее полезен в ситуациях, когда степень выполнения операции не может быть точно рассчитана и представлена в виде значения из диапазона значений (например, при приеме файла неизвестного размера).

При работе в описанном режиме вы должны вызывать метод pulse() через равные промежутки времени. Вы также можете выбрать размер шага с помощью метода set_pulse_step().

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

7.4.2. Пример

Рисунок 7-7: Индикатор выполнения задачи (ProgressBar)

Исходный код

Файл 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_Alignment(0.5, 0.5, 0, 0),
  m_CheckButton_Text("Показывать текст"),
  m_CheckButton_Activity("Режим активности"),
  m_CheckButton_Inverted("Справа налево"),
  m_Button_Close("Закрыть"),
  m_bActivityMode(false)
{
  set_resizable();
  set_title("Пример использования класса Gtk::ProgressBar");

m_VBox.set_border_width(10);
  add(m_VBox);

m_VBox.pack_start(m_Alignment, Gtk::PACK_SHRINK, 5);
  m_Alignment.add(m_ProgressBar);
  m_ProgressBar.set_text("произвольный текст");
  m_ProgressBar.set_show_text(false);

//Добавление функции обратного вызова с таймером для обновления значения индикатора выполнения задачи:
  m_connection_id_timeout = Glib::signal_timeout().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_timeout), 50 );

m_VBox.pack_start(m_Separator, Gtk::PACK_SHRINK);
  m_VBox.pack_start(m_Grid);
  m_Grid.set_row_homogeneous(true);

//Добавление флажка для вывода текста:
  m_Grid.attach(m_CheckButton_Text, 0, 0, 1, 1);
  m_CheckButton_Text.property_margin() = 5;
  m_CheckButton_Text.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_checkbutton_text) );

//Добавление флажка для активации режима активности:
  m_Grid.attach(m_CheckButton_Activity, 0, 1, 1, 1);
  m_CheckButton_Activity.property_margin() = 5;
  m_CheckButton_Activity.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_checkbutton_activity) );

//Добавление флажка для переключения режимов индикатора слева направо и справа налево:
  m_Grid.attach(m_CheckButton_Inverted, 0, 2, 1, 1);
  m_CheckButton_Inverted.property_margin() = 5;
  m_CheckButton_Inverted.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_checkbutton_inverted) );

//Добавление кнопки для выхода из программы.
  m_VBox.pack_start(m_Button_Close, Gtk::PACK_SHRINK);
  m_Button_Close.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_close) );
  m_Button_Close.set_can_default();
  m_Button_Close.grab_default();

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_checkbutton_text()
{
  const bool show_text = m_CheckButton_Text.get_active();
  m_ProgressBar.set_show_text(show_text);
}

void ExampleWindow::on_checkbutton_activity()
{
  m_bActivityMode = m_CheckButton_Activity.get_active();

if(m_bActivityMode)
    m_ProgressBar.pulse();
  else
    m_ProgressBar.set_fraction(0.0);
}

void ExampleWindow::on_checkbutton_inverted()
{
  const bool inverted = m_CheckButton_Inverted.get_active();
  m_ProgressBar.set_inverted(inverted);
}

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

/* Обновление значения индикатора выполнения задачи для
 * иллюстрации его перемещения */
bool ExampleWindow::on_timeout()
{
  if(m_bActivityMode)
    m_ProgressBar.pulse();
  else
  {
    double new_val = m_ProgressBar.get_fraction() + 0.01;

if(new_val > 1.0)
      new_val = 0.0;

//Set the new value:
    m_ProgressBar.set_fraction(new_val);
  }

//Так как это вызываемая по таймеру функция, возвращается логическое
  //значение true для продолжения ее использования
  return true;
}

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

7.5. Информационная панель (InfoBar)

Информационная панель позволяет демонстрировать небольшие информационные сообщения или задавать краткие вопросы. В отличие от диалоговых окон, она показывается вверху текущего окна, а не в новом открытом окне. API соответствующего класса очень схож с API класса Gtk::Dialog.

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

7.5.1. Пример

Рисунок 7-8: Информационная панель
Информационная панель (InfoBar)

Исходный код

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

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

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_VBox(Gtk::ORIENTATION_VERTICAL, 6),
  m_Button_Quit("_Выход", true),
  m_Button_Clear("_Очистить", true)
{
  set_title("Пример использования класса Gtk::InfoBar");
  set_border_width(6);
  set_default_size(400, 200);

add(m_VBox);

// Добавление виджета строки на информационную панель:
  Gtk::Container* infoBarContainer =
    dynamic_cast<Gtk::Container*>(m_InfoBar.get_content_area());
  if (infoBarContainer)
    infoBarContainer->add(m_Message_Label);

// Добавление кнопки OK на информационную панель:
  m_InfoBar.add_button("_OK", 0);

// Добавление информационной панели в вертикальный контейнер:
  m_VBox.pack_start(m_InfoBar, Gtk::PACK_SHRINK);

// Создание текстового буфера и передача его виджету ввода текста:
  m_refTextBuffer = Gtk::TextBuffer::create();
  m_TextView.set_buffer(m_refTextBuffer);

// Добавление виджета вывода древовидных структур в контейнерный виджет окна прокрутки:
  m_ScrolledWindow.add(m_TextView);

// Показ полос прокрутки только тогда, когда они необходимы:
  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_Clear, Gtk::PACK_SHRINK);
  m_ButtonBox.pack_start(m_Button_Quit, Gtk::PACK_SHRINK);
  m_ButtonBox.set_spacing(6);
  m_ButtonBox.set_layout(Gtk::BUTTONBOX_END);

// Соединение с обработчиками сигналов:
  m_InfoBar.signal_response().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_infobar_response) );
  m_Button_Quit.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_quit) );
  m_Button_Clear.signal_clicked().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_button_clear) );
  m_refTextBuffer->signal_changed().connect(sigc::mem_fun(*this,
              &ExampleWindow::on_textbuffer_changed) );

show_all_children();

// Сокрытие информационной панели до момента показа сообщения:
  m_InfoBar.hide();

// Следует сделать кнопку очистки неактивной до момента ввода текста в буфер.
  // В момент, когда кнопка активна и нажата, происходит показ информационной панели с
  // сообщением.
  m_Button_Clear.set_sensitive(false);
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_infobar_response(int)
{
  // Очистка текста сообщения и сокрытие информационной панели:
  m_Message_Label.set_text("");
  m_InfoBar.hide();
}

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

void ExampleWindow::on_button_clear()
{
  m_refTextBuffer->set_text("");
  m_Message_Label.set_text("Текст сообщения удален.");
  m_InfoBar.set_message_type(Gtk::MESSAGE_INFO);
  m_InfoBar.show();
}

void ExampleWindow::on_textbuffer_changed()
{
  m_Button_Clear.set_sensitive(m_refTextBuffer->size() > 0);
}

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

7.6. Всплывающие подсказки (Tooltips)

Всплывающие подсказки являются небольшими информационными окнами, которые показываются в момент, когда вы оставляете на несколько секунд курсор мыши над виджетом. Следует использовать метод set_tooltip_text() для установки текста всплывающей подсказки для любого виджета. Класс Gtk::ToolItem не представляет виджеты, но имеет такой же метод для удобства использования. Класс Gtk::Tooltip используется для вывода более сложных данных, таких, как изображения с текстом.

Справочная информация для класса Gtk::Widget

Справочная информация для класса Gtk::Tooltip

7.6.1. Пример

Рисунок 7-9: Всплывающая подсказка (Tooltip)

Исходный код

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

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

#include "examplewindow.h"

#include <vector>

const Glib::ustring app_title = "пример всплывающих подсказок в gtkmm";
const Glib::ustring non_markedup_tip = "Всплывающая подсказка без разметки.";
const Glib::ustring markedup_tip = "<i>Разметка</i> в всплывающей подсказке.";

ExampleWindow::ExampleWindow()
  :
  m_vbox(Gtk::ORIENTATION_VERTICAL, 3),
  m_checkbutton("Нажмите для переключения разметки в всплывающей подсказке"),
  m_label("Строка"),
  m_button("Произвольный виджет в окне всплывающей подсказки"),
  m_button_tooltip_window(Gtk::WINDOW_POPUP)
{
  //Настройка окна и контейнера:
  set_title(app_title);
  set_border_width(10);

add(m_vbox);

//Флажок для включения разметки в всплывающей подсказке:
  m_checkbutton.set_tooltip_text(non_markedup_tip);
  m_vbox.pack_start(m_checkbutton, Gtk::PACK_SHRINK);

//Строка:
  m_label.set_tooltip_text("Другая всплывающая подсказка");
  m_vbox.pack_start(m_label, Gtk::PACK_SHRINK);

//Виджет ввода текста:
  prepare_textview();

//Кнопка:
  // Метод set_tooltip_window(), как и метод set_tooltip_text()
  // вызовет метод set_has_tooltip() для нас.
  m_button.set_tooltip_window(m_button_tooltip_window);
  m_vbox.pack_start(m_button, Gtk::PACK_SHRINK);

//Специальное окно всплывающей подсказки для кнопки:
  m_button_tooltip_window.set_default_size(250, 30);
  Gtk::Label* label =
    Gtk::manage(new Gtk::Label("Строка в специальном окне всплывающей подсказки"));
  label->show();
  m_button_tooltip_window.add(*label);

connect_signals();

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::prepare_textview()
{
  Gtk::TextIter iter;
  std::vector< Glib::RefPtr<Gtk::TextTag> > tags;

//Настройка окна прокрутки:
  m_scrolled_window.add(m_text_view);
  m_scrolled_window.set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);
  m_vbox.pack_start(m_scrolled_window);

//Создание текстового буфера с текстом:
  m_ref_text_buffer = Gtk::TextBuffer::create();

iter = m_ref_text_buffer->end();
  m_ref_text_buffer->insert(iter, "Проведите курсором мыши над текстом, ");

//Вставка текста с тэгом.
  //В обработчике сигнала показа всплывающей подсказки ниже мы будем показывать
  //всплывающую подсказку в момент, когда курсор мыши будет находиться над текстом с тэгом.
  m_ref_bold_tag = m_ref_text_buffer->create_tag("bold");
  m_ref_bold_tag->set_property("weight", Pango::WEIGHT_BOLD);

tags.push_back(m_ref_bold_tag);

iter = m_ref_text_buffer->end();
  m_ref_text_buffer->insert_with_tags(iter, "выделенным жирным шрифтом,", tags);

iter = m_ref_text_buffer->end();
  m_ref_text_buffer->insert(iter, " для того, чтобы увидеть всплывающую подсказку");

m_text_view.set_buffer(m_ref_text_buffer);

m_text_view.set_size_request(320, 50);

//При подключении обработчика сигнала "query-tooltip" без использования методов
  //set_tooltip_text(), set_tooltip_markup() или set_tooltip_window(),
  //мы должны четко сообщить GTK+ о том, что виджет имеет всплывающую подсказку,
  //которую мы и будем показывать.
  m_text_view.set_has_tooltip();
}

void ExampleWindow::connect_signals()
{
  m_checkbutton.signal_clicked().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_markup_checkbutton_click));

m_text_view.signal_query_tooltip().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_textview_query_tooltip));

m_button.signal_query_tooltip().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_button_query_tooltip));
}

void ExampleWindow::on_markup_checkbutton_click()
{
  if (m_checkbutton.get_active() == true)
  {
    m_checkbutton.set_tooltip_markup(markedup_tip);
  }
  else
  {
    m_checkbutton.set_tooltip_markup(non_markedup_tip);
  }
}

bool ExampleWindow::on_textview_query_tooltip(int x, int y, bool keyboard_tooltip, const Glib::RefPtr<Gtk::Tooltip>& tooltip)
{
  Gtk::TextIter iter;

if (keyboard_tooltip)
  {
    int offset = m_ref_text_buffer->property_cursor_position().get_value();
    iter = m_ref_text_buffer->get_iter_at_offset(offset);
  }
  else
  {
    int mouse_x, mouse_y, trailing;
    m_text_view.window_to_buffer_coords(Gtk::TEXT_WINDOW_TEXT,
                                        x, y, mouse_x, mouse_y);
    m_text_view.get_iter_at_position(iter, trailing, mouse_x, mouse_y);
  }

//Показ всплывающей подсказки в момент нахождения курсора мыши над текстом
  //с определенным тэгом:
  if (iter.has_tag(m_ref_bold_tag))
  {
    tooltip->set_markup("<b>Информация</b>, связанная с тэгом в тексте");
    tooltip->set_icon_from_icon_name("dialog-information", Gtk::ICON_SIZE_MENU);
  }
  else
  {
    return false;
  }

return true;
}

bool ExampleWindow::on_button_query_tooltip(int, int, bool, const Glib::RefPtr<Gtk::Tooltip>&)
{
  //Мы уже создали специальное окно, а теперь просто возвращаем логическое значение true для его показа:
  return true;
}

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

Следующий раздел : 8. Контейнерные виджеты.