Отображение списков. Часть 1

Мы начинаем знакомство с большой темой - отображением списков.

Сегодня будет разработана простая программа, дающая представление о данной теме и являющаяся основой для последующих статей.



Сначала необходимо создать модель списка. Это некая структура, хранящая в себе все данные, которые необходимо поместить в список. При её создании нужно указать тип колонки. Их существует 15 видов, но в большинстве случаев достаточно одного строкового - GObject::TYPE_STRING. С полным списком типов можете ознакомиться здесь (правда там устаревшая документация, вместо Gtk:: нужно использовать GObject::). Количество параметров, передаваемых данному классу должно быть равно количеству колонок.

$store = new GtkListStore(GObject::TYPE_STRING, GObject::TYPE_STRING);

Теперь нужно заполнить модель. Для этого предназначен метод append(), которому передаётся массив, содержащий добавляемые данные. Один вызов append() добавляет в модель одну строчку. Мы же добавим три:

$store->append(array('1.1', '1.2'));
$store->append(array('2.1', '2.2'));
$store->append(array('3.1', '3.2'));

Для отображения модели в окне используется класс GtkTreeView:

$view = new GtkTreeView($store);

У нас уже есть готовая модель и виджет, отображающий её. Остаётся только создать две колонки, т.к. без них GtkTreeView бесполезен. Для их создания используем класс GtkTreeViewColumn, которому первым параметром передаётся имя колонки; вторым - объект GtkCellRendererText, предназначенный для отображения текстовой информации в колонке; третьим - аттрибут, имеющий значение 'text' для GtkCellRendererText; четвёртым - целочисленный идентификатор колонки. Затем методом append_column() добавим созданную колонку в GtkTreeView.

$render = new GtkCellRendererText;
$view->append_column(new GtkTreeViewColumn('Колонка 1', $render, 'text', 0));
$view->append_column(new GtkTreeViewColumn('Колонка 2', $render, 'text', 1));

Для того, чтобы большие объёмы данных не выходили за пределы окна поместим GtkTreeView в область с полосами прокрутки. О том, как это сделать описано в статье Полосы прокрутки.

Полный код программы:

<?php
 
$window = new GtkWindow;
$window->set_size_request(200, 100);
$window->connect_simple('destroy', array('Gtk', 'main_quit'));
 
$store = new GtkListStore(GObject::TYPE_STRING, GObject::TYPE_STRING);
$store->append(array('1.1', '1.2'));
$store->append(array('2.1', '2.2'));
$store->append(array('3.1', '3.2'));
 
$view = new GtkTreeView($store);
 
$render = new GtkCellRendererText;
$view->append_column(new GtkTreeViewColumn('Колонка 1', $render, 'text', 0));
$view->append_column(new GtkTreeViewColumn('Колонка 2', $render, 'text', 1));
 
$scroll = new GtkScrolledWindow();
$scroll->set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);
$scroll->add($view);
 
$window->add($scroll);
$window->show_all();
Gtk::main();
 
?>