DatabaseTree

Графический объект; дерево значений.

Шаблон DatabaseTree

Перечень всех возможных тэгов объекта:

<MyObject Name="" Type="DatabaseTree" Assembly="ComplexControls" ChangeForm="">
  <!--Тэги, общие для всех графических объектов-->
  <Top></Top>
  <Bottom></Bottom>
  <Left></Left>
  <Right></Right>
  <Height></Height>
  <Width></Width>
  <FontStyle></FontStyle>
  <ForeColor></ForeColor>
  <BackColor></BackColor>
  <Enabled></Enabled>
  <Visible></Visible>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для DatabaseTree-->
  <BorderStyle></BorderStyle>
  <HideSelection></HideSelection>
  <Sorted></Sorted>
  <Items>
    <DataConnection SourceDataConnection="VariantRelationPrimaryGetDataConnection">
      <SourceQuery Name="ItemVariant">
        <Fields>
          <Field Name="" />
          <Field Name="" />
        </Fields>
      </SourceQuery>
      <SourceQuery Name="VariantVariant">
        <Fields>
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
        </Fields>
      </SourceQuery>
    </DataConnection>
  </Items>
  <TopItems></TopItems>
</MyObject>

Описание DatabaseTree

<MyObject Name="DatabaseTreeName" Type="DatabaseTree" Assembly="BaseControls">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для DatabaseTree-->
</MyObject>

Получение значения

Значением DatabaseTree считается значение выделенного узла.

<Object Name="DatabaseTreeName" />

Задать значение DatabaseTree нельзя.

Тэги, специфичные для DatabaseTree

BorderStyle

Название типа границ дерева.

Необязательный тэг. Ожидается название одного из типов границ дерева:

None	Нет границ
FixedSingle	Одиночная плоская
Fixed3D	Одиночная объемная

По умолчанию используется значение FixedSingle.

<BorderStyle>FixedSingle</BorderStyle>

HideSelection

Признак видимости выделенного элемента в дереве.

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение True.

<HideSelection>True</HideSelection>

Sorted

Признак сортировки элементов дерева по отображаемым значениям.

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение False.

<Sorted>False</Sorted>

Items

Элементы дерева и их взаимосвязи списка.

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

Первая таблица соответствует линейному списку элементов дерева: первое поле будет соответствовать идентификатору элемента, второе - его отображаемому значению.

Вторая таблица соответствует взаимосвязям элементов дерева: первое поле будет соответствовать дочернему идентификатору элемента, второе - родительскому, а третье (необязательное поле) - признаку видимости данной взаимосвязи.

Один элемент может входить в несколько родительских элементов.

<Items>
  <DataConnection SourceDataConnection="VariantRelationPrimaryGetDataConnection">
    <SourceQuery Name="ItemVariant">
      <Fields>
        <Field Name="VariantId" />
        <Field Name="ViewItemTitle" />
      </Fields>
    </SourceQuery>
    <SourceQuery Name="VariantVariant">
      <Fields>
        <Field Name="ChildVariantId" />
        <Field Name="ParentVariantId" />
        <Field Name="VariantBase" />
      </Fields>
    </SourceQuery>
  </DataConnection>
</Items>

TopItems

Идентификаторы узлов верхнего уровня дерева.

Необязательный тэг. Ожидается массив любых значений или любое скалярное значение.

Если тэг <TopItems> отсутствует, то значения верхнего уровня находятся автоматически.

<TopItems>1</TopItems>

Get-проперти для получения свойств

BorderStyle

Возвращает название типа границ дерева.

<Object Name="DatabaseTreeName">
  <Property Name="BorderStyle" />
</Object>

HideSelection

Возвращает признак видимости выделенного элемента в дереве.

<Object Name="DatabaseTreeName">
  <Property Name="HideSelection" />
</Object>

Sorted

Возвращает признак сортировки элементов дерева по отображаемым значениям.

<Object Name="DatabaseTreeName">
  <Property Name="Sorted" />
</Object>

SelectedItemId

Возвращает идентификатор выделенного узла дерева.

<Object Name="DatabaseTreeName">
  <Property Name="SelectedItemId" />
</Object>

SelectedItemTitle

Возвращает отображаемое значение выделенного узла дерева.

<Object Name="DatabaseTreeName">
  <Property Name="SelectedItemTitle" />
</Object>

ParentSelectedItemId

Возвращает идентификатор родительского узла дерева по отношению к выделенному узлу.

<Object Name="DatabaseTreeName">
  <Property Name="ParentSelectedItemId" />
</Object>

ItemsParentalRelation

Возвращает признак, определяющий, входит ли узел дерева с идентификатором PossibleChildItemId в узел с идентификатором PossibleParentItemId.

<Object Name="DatabaseTreeName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="ItemsParentalRelation">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным PossibleChildItemId: ожидается любое значение, равное идентификатору узла дерева-->
      <Parameter Name="PossibleChildItemId">ChildNodeId</Parameter>
      <!--Значение тэга Parameter с атрибутом Name, равным PossibleParentItemId: ожидается любое значение, равное идентификатору узла дерева-->
      <Parameter Name="PossibleParentItemId">ParentNodeId</Parameter>
    </Parameters>
  </Property>
</Object>

SelectedNodeHasChildren

Возвращает признак, определяющий, имеет ли выделенный узел дочерние узлы.

<Object Name="DatabaseTreeName">
  <Property Name="SelectedNodeHasChildren" />
</Object>

ItemTitleByItemId

Возвращает отображаемое значение узла дерева по его идентификатору.

<Object Name="DatabaseTreeName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="ItemTitleByItemId">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Value: ожидается любое значение, равное идентификатору узла дерева-->
      <Parameter Name="Value">NodeId</Parameter>
    </Parameters>
  </Property>
</Object>

ItemAdded

Возвращает признак, определяющий, был ли узел дерева с указанным идентификатором сохранен в базе данных.

<Object Name="DatabaseTreeName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="ItemAdded">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Value: ожидается любое значение, равное идентификатору узла дерева-->
      <Parameter Name="Value">NodeId</Parameter>
    </Parameters>
  </Property>
</Object>

ExpandedNodesIds

Возвращает массив идентификаторов открытых (видимых) элементов.

<Object Name="DatabaseTreeName">
  <Property Name="ExpandedNodesIds" />
</Object>

SelectedItemLevel

Возвращает номер уровня, на котором находится выделенный в дереве элемент.

<Object Name="DatabaseTreeName">
  <Property Name="SelectedItemLevel" />
</Object>

Set-проперти для динамического задания свойств

BorderStyle

Задает название типа границ дерева.

Ожидается название одного из типов границ дерева.

<Object Name="DatabaseTreeName">
  <Property Name="BorderStyle">Fixed3D</Property>
</Object>

HideSelection

Задает признак видимости выделенного элемента в дереве.

Ожидается логическое значение.

<Object Name="DatabaseTreeName">
  <Property Name="HideSelection">True</Property>
</Object>

Sorted

Задает признак сортировки элементов дерева по отображаемым значениям.

Ожидается логическое значение.

<Object Name="DatabaseTreeName">
  <Property Name="Sorted">True</Property>
</Object>

SelectedItemId

Задает идентификатор выделенного узла дерева.

Ожидается любое значение, равное идентификатору узла дерева.

<Object Name="DatabaseTreeName">
  <Property Name="SelectedItemId">NodeId</Property>
</Object>

InsertItem

Добавляет в узел ParentItemId дерева новый узел с идентификатором ItemId, отображаемым значением ItemTitle, добавленный узел выделяется в соответствии с признаком SelectAfterAdd.

<Object Name="DatabaseTreeName">
  <!--Значение тэга Property: ожидается любое значение-->
  <Property Name="InsertItem">
    <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным ItemId: ожидается любое значение с идентификатором добавляемого узла-->
      <!--Если узел с данным идентификатором уже есть в дереве, новый узел добавлен не будет-->
      <Parameter Name="ItemId">-1</Parameter>
      <!--Необязательный параметр. При отсутствии используется пустая строка-->
      <!--Значение тэга Parameter с атрибутом Name, равным ItemTitle: ожидается любое значение с отображаемым названием добавляемого узла-->
      <Parameter Name="ItemTitle">NodeTitle</Parameter>
      <!--Необязательный параметр. При отсутствии узел будет добавлен на верхний уровень дерева-->
      <!--Значение тэга Parameter с атрибутом Name, равным ParentItemId: ожидается любое значение, равное идентификатору узла дерева, к которому будет добавляться новый узел-->
      <!--Если узел с переданным родительским идентификатором отсутствует в дереве, то новый узел добавлен не будет-->
      <Parameter Name="ParentItemId">0</Parameter>
      <!--Необязательный параметр. При отсутствии используется значение True-->
      <!--Значение тэга Parameter с атрибутом Name, равным SelectAfterInsert: ожидается логическое значение-->
      <Parameter Name="SelectAfterInsert">True</Parameter>
    </Parameters>
  </Property>
</Object>

InsertItemIntoSelectedNode

Добавляет новый узел с отображаемым значением и идентификатором -1 в выделенный узел дерева.

Ожидается любое значение.

<Object Name="DatabaseTreeName">
  <Property Name="InsertItemIntoSelectedNode">NodeTitle</Property>
</Object>

UpdateSelectedItemTitle

Изменяет отображаемое значение выделенного узла дерева.

Ожидается любое значение.

<Object Name="DatabaseTreeName">
  <Property Name="UpdateSelectedItemTitle">NewNodeTitle</Property>
</Object>

DeleteSelectedItem

Удаляет выделенный узел дерева.

Значение тэга Property: не ожидается.

<Object Name="DatabaseTreeName">
  <Property Name="DeleteSelectedItem" />
</Object>

TransferSelectedItem

Переносит выделенный узел дерева в указанный.

Ожидается любое значение, равное идентификатору узла дерева.

<Object Name="DatabaseTreeName">
  <Property Name="TransferSelectedItem">NodeId</Property>
</Object>

TransferItem

Переносит один узел дерева в другой.

<Object Name="DatabaseTreeName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="TransferItem">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным SourceNodeId: ожидается любое значение, равное идентификатору узла дерева, соответствующее переносимому узлу-->
      <Parameter Name="SourceNodeId">SourceNodeId</Parameter>
      <!--Значение тэга Parameter с атрибутом Name, равным DestinationNodeId: ожидается любое значение, равное идентификатору узла дерева, в который будет осуществлен перенос-->
      <Parameter Name="DestinationNodeId">DestinationNodeId</Parameter>
    </Parameters>
  </Property>
</Object>

ReplaceItemVisibility

Изменяет видимость элемента с идентификатором OldNodeIdVisible на видимость элемента с идентификатором NewNodeIdVisible в рамках одного родительского узла с идентификатором ParentItemId.

<Object Name="DatabaseTableName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="ReplaceItemVisibility">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным ParentItemId: ожидается любое значение, равное идентификатору узла дерева, соответствующее родительскому узлу-->
      <Parameter Name="ParentItemId">ParentNodeId</Parameter>
      <!--Значение тэга Parameter с атрибутом Name, равным OldNodeIdVisible: ожидается любое значение, равное идентификатору узла дерева в рамках одного родительского узла-->
      <Parameter Name="OldNodeIdVisible">OldNodeId</Parameter>
      <!--Значение тэга Parameter с атрибутом Name, равным NewNodeIdVisible: ожидается любое значение, равное идентификатору узла дерева в рамках одного родительского узла-->
      <Parameter Name="NewNodeIdVisible">NewNodeId</Parameter>
    </Parameters>
  </Property>
</Object>

ExpandNodeId

Раскрывает указанный узел дерева.

Ожидается любое значение, равное идентификатору узла дерева.

<Object Name="DatabaseTreeName">
  <Property Name="ExpandNodeId">NodeId</Property>
</Object>

ExpandNodeTitle

Раскрывает узел дерева, содержащий определенный текст.

Ожидается любое значение.

<Object Name="DatabaseTreeName">
  <Property Name="ExpandNodeTitle">NodeTitle</Property>
</Object>

ExpandAll

Раскрывает все узлы дерева.

Значение тэга Property: не ожидается.

<Object Name="DatabaseTreeName">
  <Property Name="ExpandAll" />
</Object>

ExpandLevel

Раскрывает все узлы дерева до определенного уровня.

Ожидается целочисленное значение.

<Object Name="DatabaseTreeName">
  <Property Name="ExpandLevel">1</Property>
</Object>

CollapseAll

Сворачивает все узлы дерева.

Значение тэга Property: не ожидается.

<Object Name="DatabaseTreeName">
  <Property Name="CollapseAll" />
</Object>

ClearSelection

Сбрасывает текущее выделение узла дерева.

Значение тэга Property: не ожидается.

<Object Name="DatabaseTreeName">
  <Property Name="ClearSelection" />
</Object>