Шаг 47.
Библиотека Tkinter. Компоненты и вспомогательные классы. Стилизуемые компоненты. Компонент Treeview: иерархический список

    На этом шаге мы рассмотрим опции этого компонента.

    Компонент иерархического списка, представляемый классом Treeview, - самый сложный среди всех, определенных в модуле tkinter.ttk.

    Компонент предназначен для вывода иерархического списка, представленного в виде таблицы из произвольного количества столбцов (рисунок 1).

Рис.1. Компонент Treeview, отображающий иерархический список

    Каждый пункт такого списка может содержать сколько угодно вложенных в него пунктов. Пункт, в который вложены другие пункты, носит название родителя, а вложенные в него пункты - потомков. Слева от каждого пункта-родителя находится знакомый нам значок, с помощью которого производится разворачивание и сворачивание пункта.

    Однако с помощью этого компонента можно вывести и обычный список, также представленный в виде таблицы. Пример такого списка можно увидеть на рисунке 2.

Рис.2. Компонент Treeview, отображающий обычную таблицу

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

• columns - устанавливает набор столбцов для списка. Значение задается в виде последовательности идентификаторов столбцов, представленных в виде строк. Эти идентификаторы впоследствии будут использоваться нами для ссылки на различные столбцы списка:

    trwPlatforms = tkinter.ttk.Treeview(self, columns=("Name", "Version"))
  

  В результате список trwPlatforms будет содержать столбцы с внутренними идентификаторами Name и Version.

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

      Опция columns задает физический порядок расположения столбцов и их физические номера. Так, в нашем случае служебный столбец будет иметь физический номер 0, столбец Name - 1, а столбец Version - 2;

• displaycolumns - задает набор и последовательность столбцов, которые должны быть выведены на экран. В качестве значения можно использовать:
  • строку "#all" - для вывода всех столбцов, указанных в опции columns, в том порядке, в котором они были там записаны;
  • последовательность порядковых номеров столбцов, указанных в опции columns, которые записаны в виде целых чисел. Нумерация столбцов начинается с 0;
  • последовательность внутренних идентификаторов столбцов, указанных в опции columns, которые записаны в виде строк.

      В последних двух случаях столбцы, не указанные в последовательности, не будут выведены на экран. Отметим, что служебный столбец, содержащий значки для разворачивания и сворачивания пунктов, все равно будет выведен - скрыть его посредством опции displaycolumns не получится.

      Приведем пару примеров:

    trwPlatforms = tkinter.ttk.Treeview(self, columns=("Name", "Version"), 
       displaycolumns=(1, 0)) 
  

  В результате сначала будет выведен служебный столбец (как мы только что узнали, скрыть его не получится), за ним - второй из определенных нами (Version), а потом - первый (Name).

    trwPlatforms = tkinter.ttk.Treeview(self, columns=("Name", "Version"), 
      displaycolumns=("Name",))
  

  В результате будет выведен только столбец Name, не считая служебного.

      Опция displaycolumns задаёт логический порядок расположения столбцов и их логические номера. Так, в первом примере служебный столбец будет иметь логический номер 0, выведенный за ним столбец Version - 1, а столбец Name, идущий последним, - 2;

• show -управляет выводом служебного столбца и шапки таблицы. Можно задать такие значения:
  • пустая строка или None - служебный столбец и шапка не выводятся;
  • "tree" - служебный столбец выводится, шапка - нет;
  • "headings" - шапка выводится, служебный столбец - нет;
  • "tree headings" - выводятся и служебный столбец, и шапка.
  Вот пример скрытия служебного столбца и вывода шапки:

    trwPlatforms["show"] = "headings"
  

• selectmode - устанавливает режим выбора строк в списке. Поддерживаются три значения:
  • "browse" - можно выбрать только одну строку (поведение по умолчанию);
  • "extended" - можно выбрать сразу несколько строк;
  • "none" - выбор строк невозможен;

• padding - указывает отступы между границами компонента и его содержимым. Значение может быть задано в виде:
  • одной дистанции - указывает отступы слева, сверху, справа и снизу;
  • последовательности из двух дистанций: первая укажет отступы слева и сверху, а вторая - справа и снизу;
  • последовательности из трех дистанций: первая укажет отступы слева, вторая - справа, а третья - сверху и снизу;
  • последовательности из четырех дистанций: первая укажет отступы слева, вторая - сверху, третья - справа, а четвертая - снизу;

• height - задает высоту списка в строках.

    На следующем шаге мы рассмотрим методы этого виджета.

Предыдущий шаг Содержание Следующий шаг