Компонент DBTreeFilter

Автор Юрасов Вадим ,
дата публикации 24 сентября 2003г.

Назначение и применение

Компонент DBTreeFilter предназначен для визуализации иерархических структур, хранящихся в реляционных источниках данных. От обычного DBTreeView компонент отличатся возможностью выбора конкретных элементов построенного дерева и получением этого набора в виде перечня отмеченных элементов. Результат можно использо-вать в качестве фильтра для запросов, входного параметра хранимых процедур и т.д.

Компонент разработан для языка программирования Borland Delphi версий 5, 6 и 7.

Описание

В качестве источника данных для построения дерева используется dataset (таблица, запрос, хранимая процедура). В данном случае применяется классическая для DBTreeView структура:

Код элементаКод родителяНаименование элемента Признак группы

Поле "Признак группы" является необязательным. Оно служит для ускорения построения дерева. То есть, если есть возможность указать, что у данного элемента могут быть потомки, то это лучше сделать.

Дерево можно строить в двух режимах: все сразу, до конечных уровней и постепенно, в процессе просмотра (при раскрытии ветки). Переключатель режимов - свойство BuildFullTree.

Возможено включение и отключение режима выбора конкретных элементов (свойство ChecksActive). При отключении получаем обычный компонент DBTreeView.

Поскольку компонент является наследником класса TTreeView, то полностью наследует его свойства и методы.

Кроме того, добавлены свойства:

BuildFullTree - строить или нет все дерево сразу (по умолчанию FALSE),
ChecksActive - включить/отключить режим выбора элементов (по умолчанию TRUE),
DataSet - источник данных,
FieldIdName - поле, содержащее код элемента,
FieldPrName - поле, содержащее код родителя,
FieldNmName - поле, содержащее наименование элемента,
FieldWithGroup - поле, в котором содержится признак группы (если свойство заполнено, то считается, что у данно-го элемента не может быть группы, если поле как текст равно '', 'FALSE' или '0'),
OutLightTree - текстовая строка, содержащая разделенные запятой коды выделенных элементов. Выбираются пер-вые по иерархии отмеченные элементы. То есть, если у нас отмечены все элементы дерева, то это свойство будет содержать только коды элементов первого уровня.

Рассмотрим работу компонента на примере иерархического классификатора принадлежности предприятий области к отраслям народного хозяйства.

В данном случае мы видим, что строка состоит только из одного кода "168", соответствующего корневому элементу "Всего по энергосистеме"

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

Если снять отметку, скажем, с Борского лесхоза, то свойство OutLightTree будет содержать уже коды отмеченных предприятий, относящихся к лесному хозяйству, поскольку сам уровень "III. Лесное хозяйство" является частично выбранным.

OutFullTree - текстовая строка, содержащая разделенные запятой коды выделенных элементов. Выбираются последние по иерархии отмеченные элементы. То есть, если у нас отмечены все элементы дерева, то это свойство будет содержать только коды элементов последних уровней. Заполнение данного свойства перед построением дерева позволяет построить дерево с сохраненными ранее отмеченными ранее элементами
Иногда возникают ситуации, когда в качестве выходной строки удобно получать коды элементов конечного уровня (например, коды видов оплат, разбитых по категориям (векселя, взаимозачеты, платежи деньгами)), поскольку это дает возможность пропустить предварительную обработку полученного набора кодов при наложении ограничения на выборку. В этом случае необходимо, чтобы дерево сразу строилось полностью (свойство BuildFullTree должно быть равно TRUE), так как иначе мы не будем иметь доступа к дочерним уровням, отмеченных групповых элементов (если только не развернем их принудительно).
Естественно, что использовать данное свойство имеет смысл только на относительно небольших структурах, когда получение "полной" выходной строки действительно себя оправдывает.
ZeroLevParId - значение поля "Код родителя", соответствующее первому уровню иерархии (по умолчанию равно NULL)

Методы:

Build() - построение дерева.

Особенности работы

Задания списка отмечаемых элементов перед построением дерева возможно только в свойстве OutFullTree c указанием конечных отмеченных элементов. Построение дерева на основе OutLightTree не реализовано ввиду сомнений в нужности данной операции).Соответственно для корректного отображения дерева следует выставить BuildFull-Tree:=True.

Построение дерева. При использовании свойства FieldWithGroup (признак группового элемента) формирование дерева идет достаточно быстро (иерархия из 6500 элементов (приведенный пример) строится 6 секунд (Pentium III 1ГГц, 256 мегабайт памяти)).

Если же данное свойство не активно, то скорость построения дерева очень сильно зависит от того, какой механизм доступа к данным используется. Если ADO, то разница настолько несущественна (на размерности в 6500 элементов - порядка 1 секунды, то есть 7 секунд на построение дерева без признака групп), что свойство FieldWithGroup можно вообще не использовать. Если же используется BDE подключение, то отключение этого свойства на больших объемах очень сильно тормозит формирование дерева. Дело в том, что в алгоритме построения для источника данных используется метод Lookup, который по разному срабатывает для ADO и BDE. Поэтому для BDE реализован несколько иной механизм, с использованием закладок, в результате чего скорость работы существенно ниже, чем при использовании ADO.

материал подготовил Титов Дмитрий

Разработчики

Компонент DBTreeFilter разработан Юрасовым Вадимом
ICQ: 69134053

при небольшом содействии Титова Дмитрия
ICQ:7824380

Скачать DBTreeFilter.zip (59K)

Последние версии компонента можно добыть по адресу http://dem.wallst.ru/soft.htm

Содержание Назад Вперед