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

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

6. Виджеты диапазонов

Классы Gtk::Scale и Gtk:Scrollbar наследуются от класса Gtk::Range и обладают сходной функциональностью. Представляемые этими классами виджеты содержат "полосу прокрутки" и "ползунок" (иногда называемые "барабаном" в других графических окружениях). Перемещение ползунка с помощью указателя мыши приводит к его движению по полосе прокрутки, а нажатие на полосу прокрутки приводит к перемещению ползунка по направлению к точке нажатия либо в саму точку, либо на определенное расстояние в зависимости от того, какая кнопка мыши была использована. Такое поведение полосы прокрутки должно быть привычным для пользователей.

Как будет описано в разделе "Объект установки диапазона значений", каждый из виджетов диапазонов ассоциируется с объектом установки диапазона значений (Adjustment). Для изменения используемых виджетом минимального, максимального и текущего значений вам необходимо использовать методы соответствующего объекта установки диапазона значений, который вы можете получить, использовав метод класса виджета get_adjustment(). Стандартные конструкторы виджетов диапазонов создают объекты установки диапазона значений автоматически, причем вы можете также указать существующий объект установки диапазона значений, возможно, для того, чтобы использовать его и для другого виджета. Обратитесь к разделу "Объект установки диапазона значений" для получения более подробной информации.

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

6.1. Виджеты полос прокрутки (Scrollbar Widgets)

Эти виджеты являются стандартными полосами прокрутки. Они должны использоваться только для прокручивания другого виджета, такого, как виджет, представленный классом Gtk::Entry или Gtk::Viewport, хотя в большинстве случаев для этой цели проще использовать виджет, представленный классом Gtk::ScrolledWindow.

Ориентация представленного классом Gtk::Scrollbar виджета может быть либо вертикальной, либо горизонтальной.

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

6.2. Виджеты изменения значений (Scale Widgets)

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

Как и в случае с полосами прокрутки, ориентация виджета может быть либо вертикальной, либо горизонтальной. Стандартный конструктор создает объект установки диапазона значений со всеми значениями, равными 0.0. Эти значения не позволят корректно использовать виджет, поэтому вам придется установить некоторые параметры диапазона значений для нормальной работы.

6.2.1. Полезные методы

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

Значение, выводимое виджетом изменения значений по умолчанию округляются до одного десятичного разряда в соответствии со значением, заданным с помощью параметра value соответствующего экземпляра класса Gtk::Adjustment. Вы можете использовать метод set_digits() для изменения этого параметра.

Также следует помнить о том, что значение может выводиться в различных позициях относительно полосы прокрутки, причем позиция задается с помощью метода set_value_pos().

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

6.3. Политики обновления значений

Политики обновления значений виджетов диапазонов устанавливают моменты в процессе взаимодействия с пользователем, когда изменяется значение параметра value объекта установки диапазонов значений, являющегося экземпляром класса Gtk::Adjustment, и генерируется сигнал "value_changed". Следующие политики обновления могут устанавливаться с помощью метода set_update_policy():

Gtk::UPDATE_CONTINUOUS - Это стандартная политика. Сигнал "value_changed" генерируется постоянно, т.е., всегда, когда ползунок совершает даже минимальное перемещение.
Gtk::UPDATE_DISCONTINUOUS - Сигнал "value_changed" генерируется только тогда, когда ползунок прекратил перемещение и пользователь отпустил кнопку мыши.
Gtk::UPDATE_DELAYED - Сигнал "value_changed" генерируется тогда, когда пользователь отпускает кнопку мыши или ползунок прекращает перемещение на короткий промежуток времени.

6.4. Пример

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

Рисунок 6-1: Виджеты диапазонов

Исходный код

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

#ifndef GTKMM_EXAMPLE_RANGEWIDGETS_H
#define GTKMM_EXAMPLE_RANGEWIDGETS_H

#include <gtkmm.h>

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:
  //Обработчики сигналов:
  void on_checkbutton_toggled();
  void on_combo_position();
  void on_adjustment1_value_changed();
  void on_adjustment2_value_changed();
  void on_button_quit();

//Дочерние виджеты:
  Gtk::Box m_VBox_Top, m_VBox2, m_VBox_HScale;
  Gtk::Box m_HBox_Scales, m_HBox_Combo, m_HBox_Digits, m_HBox_PageSize;

Glib::RefPtr<Gtk::Adjustment> m_adjustment, m_adjustment_digits, m_adjustment_pagesize;

Gtk::Scale m_VScale;
  Gtk::Scale m_HScale, m_Scale_Digits, m_Scale_PageSize;

Gtk::Separator m_Separator;

Gtk::CheckButton m_CheckButton;

Gtk::Scrollbar m_Scrollbar;

//Колонки модели древовидной структуры:
  class ModelColumns : public Gtk::TreeModel::ColumnRecord
  {
  public:

ModelColumns()
    { add(m_col_position_type); add(m_col_title); }

Gtk::TreeModelColumn<Gtk::PositionType> m_col_position_type;
    Gtk::TreeModelColumn<Glib::ustring> m_col_title;
  };

ModelColumns m_Columns;

//Дочерние виджеты:
  Gtk::ComboBox m_ComboBox_Position;
  Glib::RefPtr<Gtk::ListStore> m_refTreeModel;

Gtk::Button m_Button_Quit;
};

#endif //GTKMM_EXAMPLE_RANGEWIDGETS_H

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

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

ExampleWindow::ExampleWindow()
:
  m_VBox_Top(Gtk::ORIENTATION_VERTICAL, 0),
  m_VBox2(Gtk::ORIENTATION_VERTICAL, 20),
  m_VBox_HScale(Gtk::ORIENTATION_VERTICAL, 10),
  m_HBox_Scales(Gtk::ORIENTATION_HORIZONTAL, 10),
  m_HBox_Combo(Gtk::ORIENTATION_HORIZONTAL, 10),
  m_HBox_Digits(Gtk::ORIENTATION_HORIZONTAL, 10),
  m_HBox_PageSize(Gtk::ORIENTATION_HORIZONTAL, 10),

// Значение, минимум, максимум, приращение шага, приращение страницы, размер страницы:
  // Следует учесть, что размер страницы имеет значение только для
  // виджетов полос прокрутки, и наибольшее достижимое значение будет равно
  // (максимум - размер страницы).
  m_adjustment( Gtk::Adjustment::create(0.0, 0.0, 101.0, 0.1, 1.0, 1.0) ),
  m_adjustment_digits( Gtk::Adjustment::create(1.0, 0.0, 5.0, 1.0, 2.0) ),
  m_adjustment_pagesize( Gtk::Adjustment::create(1.0, 1.0, 101.0) ),

m_VScale(m_adjustment, Gtk::ORIENTATION_VERTICAL),
  m_HScale(m_adjustment, Gtk::ORIENTATION_HORIZONTAL),
  m_Scale_Digits(m_adjustment_digits),
  m_Scale_PageSize(m_adjustment_pagesize),

// Флажок для контроля того, должно ли показываться значение или не должно:
  m_CheckButton("Показывать текущее значение виджетов диапазонов", 0),

// Повторное использование того же объекта ограничения.
  // Заметьте, что эта операция приводит к постоянному обновлению значений
  // при перемещении полосы прокрутки.
  m_Scrollbar(m_adjustment),

m_Button_Quit("Выход")
{
  set_title("Виджеты диапазонов");
  set_default_size(300, 350);

//Вертикальный виджет диапазона:
  m_VScale.set_digits(1);
  m_VScale.set_value_pos(Gtk::POS_TOP);
  m_VScale.set_draw_value();
  m_VScale.set_inverted(); // Максимальное значение сверху

//Горизонтальный виджет диапазона:
  m_HScale.set_digits(1);
  m_HScale.set_value_pos(Gtk::POS_TOP);
  m_HScale.set_draw_value();

add(m_VBox_Top);
  m_VBox_Top.pack_start(m_VBox2);
  m_VBox2.set_border_width(10);
  m_VBox2.pack_start(m_HBox_Scales);

//Размещение горизнотального и вертикального виджета диапазона
  //друг рядом с другом (над полосой прокрутки).
  m_HBox_Scales.pack_start(m_VScale);
  m_HBox_Scales.pack_start(m_VBox_HScale);

m_VBox_HScale.pack_start(m_HScale);

//Полоса прокрутки:
  m_VBox_HScale.pack_start(m_Scrollbar);

//Флажок:
  m_CheckButton.set_active();
  m_CheckButton.signal_toggled().connect( sigc::mem_fun(*this,
    &ExampleWindow::on_checkbutton_toggled) );
  m_VBox2.pack_start(m_CheckButton, Gtk::PACK_SHRINK);

//Выпадающее меню для выбора позиции вывода значений:
  //Создание модели древовидного представления:
  m_refTreeModel = Gtk::ListStore::create(m_Columns);
  m_ComboBox_Position.set_model(m_refTreeModel);
  m_ComboBox_Position.pack_start(m_Columns.m_col_title);

//Заполнение модели древовидного представления выпадающего меню:
  Gtk::TreeModel::Row row = *(m_refTreeModel->append());
  row[m_Columns.m_col_position_type] = Gtk::POS_TOP;
  row[m_Columns.m_col_title] = "Сверху";
  row = *(m_refTreeModel->append());
  row[m_Columns.m_col_position_type] = Gtk::POS_BOTTOM;
  row[m_Columns.m_col_title] = "Снизу";
  row = *(m_refTreeModel->append());
  row[m_Columns.m_col_position_type] = Gtk::POS_LEFT;
  row[m_Columns.m_col_title] = "Слева";
  row = *(m_refTreeModel->append());
  row[m_Columns.m_col_position_type] = Gtk::POS_RIGHT;
  row[m_Columns.m_col_title] = "Справа";

m_VBox2.pack_start(m_HBox_Combo, Gtk::PACK_SHRINK);
  m_HBox_Combo.pack_start(
    *Gtk::manage(new Gtk::Label("Позиция вывода значения:", 0)), Gtk::PACK_SHRINK);
  m_HBox_Combo.pack_start(m_ComboBox_Position);
  m_ComboBox_Position.signal_changed().connect( sigc::mem_fun(*this, &ExampleWindow::on_combo_position) );
  m_ComboBox_Position.set_active(0); // Первый элемент меню будет активен

//Количество разрядов:
  m_HBox_Digits.pack_start(
    *Gtk::manage(new Gtk::Label("Количество разрядов:", 0)), Gtk::PACK_SHRINK);
  m_Scale_Digits.set_digits(0);
  m_adjustment_digits->signal_value_changed().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_adjustment1_value_changed));
  m_HBox_Digits.pack_start(m_Scale_Digits);

//Размер страницы:
  m_HBox_PageSize.pack_start(
    *Gtk::manage(new Gtk::Label("Размер страницы полосы прокрутки:", 0)),
    Gtk::PACK_SHRINK);
  m_Scale_PageSize.set_digits(0);
  m_adjustment_pagesize->signal_value_changed().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_adjustment2_value_changed));
  m_HBox_PageSize.pack_start(m_Scale_PageSize);

m_VBox2.pack_start(m_HBox_Digits, Gtk::PACK_SHRINK);
  m_VBox2.pack_start(m_HBox_PageSize, Gtk::PACK_SHRINK);
  m_VBox_Top.pack_start(m_Separator, Gtk::PACK_SHRINK);
  m_VBox_Top.pack_start(m_Button_Quit, Gtk::PACK_SHRINK);

m_Button_Quit.set_can_default();
  m_Button_Quit.grab_default();
  m_Button_Quit.signal_clicked().connect(sigc::mem_fun(*this,
    &ExampleWindow::on_button_quit));
  m_Button_Quit.set_border_width(10);

show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_checkbutton_toggled()
{
  m_VScale.set_draw_value(m_CheckButton.get_active());
  m_HScale.set_draw_value(m_CheckButton.get_active());
}

void ExampleWindow::on_combo_position()
{
  Gtk::TreeModel::iterator iter = m_ComboBox_Position.get_active();
  if(!iter)
    return;

Gtk::TreeModel::Row row = *iter;
  if(!row)
    return;

const Gtk::PositionType postype = row[m_Columns.m_col_position_type];

m_VScale.set_value_pos(postype);
  m_HScale.set_value_pos(postype);
}

void ExampleWindow::on_adjustment1_value_changed()
{
  const double val = m_adjustment_digits->get_value();
  m_VScale.set_digits((int)val);
  m_HScale.set_digits((int)val);
}

void ExampleWindow::on_adjustment2_value_changed()
{
  const double val = m_adjustment_pagesize->get_value();
  m_adjustment->set_page_size(val);
  m_adjustment->set_page_increment(val);

// Заметьте, что нам не приходится генерировать сигнал "changed",
  // так как gtkmm делает это за нас.
}

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

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

Следующий раздел : 7. Виджеты общего назначения.