Процедуры и функции FORMS для работы с объектом TREE (дерево)

Создание группы записей из иерархического дерева.

PROCEDURE POPULATE_GROUP_FROM_TREE

(имя_группы VARCHAR2,

имя_метки VARCHAR2,

узел NODE);

(имя_группы VARCHAR2,

id_метки ITEM,

узел NODE);

PROCEDURE POPULATE_GROUP_FROM_TREE

(id_группы RECORDGROUP,

имя_метки VARCHAR2,

узел NODE);

PROCEDURE POPULATE_GROUP_FROM_TREE

(id_группы RECORDGROUP,

id_метки ITEM,

узел NODE);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

Имя_группы Специфицирует имя группы.

group_id Спецефицирует ID назначенное группе.

имя_метки Спецефицирует объекта создаваемого в данное время. Тип данных строка VARCHAR2 .

Id_метки Спецефицирует уникальный ID that Form Builder assigns to the item when created. Use the FIND_ITEM built-in to return the ID to an appropriately typed variable. The data type of the ID is ITEM.

node Спецефицирует a valid node. If specified, indicates a sub-tree used to populate the RecordGroup, including the specified node.

Usage Notes

The record group is cleared prior to inserting the hierarchical tree’s data set.

Clears out any data already in the hierarchical tree, and obtains the data set specified by the RecordGroup or QueryText properties.

PROCEDURE POPULATE_TREE

(имя_метки VARCHAR2);

PROCEDURE POPULATE_TREE

(id_метки ITEM);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

id_метки Спецефицирует the unique ID that Form Builder assigns to the item when created. Use the FIND_ITEM built-in to return the ID to an appropriately typed variable. The data type of the ID is ITEM.

Добавление элемента к дереву.

FUNCTION ADD_TREE_NODE

(имя_метки VARCHAR2,

node FTREE.NODE,

тир_сдвига NUMBER,

сдвиг NUMBER,

состояние NUMBER,

метка VARCHAR2,

иконка VARCHAR2,

значение VARCHAR2);

FUNCTION ADD_TREE_NODE

(id_метки ITEM,

node FTREE.NODE,

тип_сдвига NUMBER,

сдвигNUMBER,

состояние NUMBER,

метка VARCHAR2,

иконка VARCHAR2,

значение VARCHAR2);

Built-in Type unrestricted procedure

Returns NODE

Enter Query Mode no

Параметры

имя_метки Специфицирует имя объекта создаваемого в данное время. Тип данных VARCHAR2 .

Id_метки Спецефицирует the unique ID that Form Builder assigns to the item when created. Use the FIND_ITEM built-in to return the ID to an appropriately typed variable. The data type of the ID is ITEM.

node Спецефицирует a valid node.

тип_сдвига Спецефицирует the тип сдвига вершины. Возможны значения :PARENT_OFFSETSIBLING_OFFSET

сдвиг показывает позицию новой вершины. Если тип_сдвига is PARENT_OFFSET, то сдвиг может быть каждый 1-n или LAST_CHILD.Если тип_сдвига SIBLING_OFFSET, то сдвиг может быть каждый NEXT_NODE или PREVIOUS_NODE.

состояние Спецефицирует the состояние of the node. Possible vaues are:COLLAPSED_NODEEXPANDED_NODELEAF_NODE

метка Высвечивает текст для вершины.

иконка Имя файла для иконки.

значение Спецефицирует the VARCHAR2 значение для вершины.

Добавление вершин в иерархическом порядке.

PROCEDURE ADD_TREE_DATA

(id_метки ITEM,

node FTREE.NODE,

тип_сдвига NUMBER,

сдвиг NUMBER,

источник_данных NUMBER,

данные VARCHAR2);

PROCEDURE ADD_TREE_DATA

(имя_метки VARCHAR2,

node FTREE.NODE,

тип_сдвига NUMBER,

сдвигNUMBER,

источник_данных NUMBER,

данные VARCHAR2);

PROCEDURE ADD_TREE_DATA

(имя_метки VARCHAR2,

вершина FTREE.NODE,

тип_сдвига NUMBER,

сдвигNUMBER,

источник_данных NUMBER,

данные RECORDGROUP);

PROCEDURE ADD_TREE_DATA

(id_метки ITEM,

node FTREE.NODE,

тип_сдвига NUMBER,

сдвигNUMBER,

источник_данных NUMBER,

data RECORDGROUP);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует имя of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

тип_сдвига Спецефицирует the type of сдвигfor the node. Possible значениеs are:PARENT_OFFSETSIBLING_OFFSETIf тип_сдвига is PARENT_OFFSET, adds a data subset immediately under the specified node at the location among its children indicated by offset.If тип_сдвига is SIBLING_OFFSET, adds the new data as a sibling to the specified node.

offset Indicates the position of the new node.If тип_сдвига is PARENT_OFFSET, then сдвигcan be either 1-n or LAST_CHILD.If тип_сдвига is SIBLING_OFFSET, then сдвигcan be either NEXT_NODE or PREVIOUS_NODE.

источник_данных Indicates the type of data source. Possible значениеs are:RECORD_GROUPQUERY_TEXT

data Спецефицирует the data to be added. If data source is QUERY_TEXT, then data is the text of the query. If data source is RECORD_GROUP, then data is an item of type RECORDGROUP or the name of a record group.

Удаление элемента данных из иерархии.

PROCEDURE DELETE_TREE_NODE

(имя_метки VARCHAR2,

node NODE);

PROCEDURE DELETE_TREE_NODE

(id_метки ITEM,

node NODE);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

Usage Notes

Removing a branch node also removes all child nodes.

Finds the next node in the tree whose метка or значение matches the search string.

FUNCTION FIND_TREE_NODE

(имя_метки VARCHAR2,

search_string VARCHAR2,

search_type NUMBER,

search_by NUMBER,

search_root NODE,

start_point NODE);

FUNCTION FIND_TREE_NODE

(id_метки ITEM,

search_string VARCHAR2,

search_type NUMBER,

search_by NUMBER,

search_root NODE,

start_point NODE);

Built-in Type unrestricted function

Returns NODE

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

search_string Спецефицирует the VARCHAR2 search string.

search_type Спецефицирует the NUMBER search type. Possible значениеs are:FIND_NEXTFIND_NEXT_CHILD Searches just the children of the search_root node.

search_by Спецефицирует the NUMBER to search by. Possible значениеs are:NODE_МЕТКАNODE_ЗНАЧЕНИЕ

search_root Спецефицирует the root of the search tree.

start_point Спецефицирует the starting point in the NODE search.

Получение родителя узла.

FUNCTION GET_TREE_NODE_PARENT

(имя_метки VARCHAR2

node NODE);

FUNCTION GET_TREE_NODE_PARENT

(id_метки ITEM

node NODE);

Returns NODE

Built-in Type unrestricted function

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

Returns the значение of the specified property of the hierarchical tree node.

FUNCTION GET_TREE_NODE_PROPERTY

(имя_метки VARCHAR2,

node NODE,

property NUMBER);

FUNCTION GET_TREE_NODE_PROPERTY

(id_метки ITEM,

node NODE,

property NUMBER);

Returns VARCHAR2

Built-in Type unrestricted function

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

property Specify one of the following properties:NODE_СОСТОЯНИЕ Returns the состояние of the hierarchical tree node. This is either EXPANDED_NODE, COLLAPSED_NODE, or LEAF_NODE.NODE_DEPTH Returns the nesting level of the hierarchical tree node.NODE_МЕТКА Returns the меткаNODE_ИКОНКА Returns the иконка nameNODE_ЗНАЧЕНИЕ Returns the значение of the hierarchical tree node.

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

FUNCTION GET_TREE_PROPERTY

(имя_метки VARCHAR2,

property NUMBER);

FUNCTION GET_TREE_PROPERTY

(id_метки ITEM,

property NUMBER);

Returns VARCHAR2

Built-in Type unrestricted function

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name you gave the object when you created it. The data type of the name is VARCHAR2 string.

property Specify one of the following properties:DATASOURCE Returns the source used to initially populate the hierarchical tree, either in Form Builder or by using the SET_TREE_PROPERTY built-in. Returns EXTERNAL if neither property was set in Form Builder.RECORD_GROUP Returns the RecordGroup used to initially populate the hierarchical tree, either in Form Builder or by using the SET_TREE_PROPERTY built-in.. This may be a null string.QUERY_TEXT Returns the text of the query used to initially populate the hierarchical tree, either in Form Builder or by using the SET_TREE_PROPERTY built-in.. This may be a null string.NODE_COUNT Returns the number of rows in the hierarchical tree data set.SELECTION_COUNT Returns the number of selected rows in the hierarchical tree.ALLOW_EMPTY_BRANCHES Returns the character string TRUE or FALSE.ALLOW_MULTI-SELECT Returns the character string TRUE or FALSE.

Usage Notes

The значениеs returned by datasource RECORD_GROUP and QUERY_TEXT do not necessarily reflect the current data or состояние of the tree.

Получение вершины указанной выбором. Selection is an index into the list of selected nodes.

FUNCTION GET_TREE_SELECTION

(имя_метки VARCHAR2,

selection NUMBER);

FUNCTION GET_TREE_SELECTION

(id_метки ITEM,

selection NUMBER);

Returns FTREE.NODE

Built-in Type unrestricted function

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

selection Спецефицирует the selection of a single node.

Sets the состояние of a branch node.

PROCEDURE SET_TREE_NODE_PROPERTY

(имя_метки VARCHAR2,

node FTREE.NODE,

property NUMBER,

значение NUMBER);

PROCEDURE SET_TREE_NODE_PROPERTY

(имя_метки VARCHAR2,

node FTREE.NODE,

property NUMBER,

значение VARCHAR2);

PROCEDURE SET_TREE_NODE_PROPERTY

(id_метки ITEM,

node FTREE.NODE,

property NUMBER,

значение NUMBER);

PROCEDURE SET_TREE_NODE_PROPERTY

(id_метки ITEM,

node FTREE.NODE,

property NUMBER,

значение VARCHAR2);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

property Specify one of the following properties:NODE_СОСТОЯНИЕ Possible значениеs are EXPANDED_NODE, COLLAPSED_NODE, and LEAF_NODE.NODE_МЕТКА Sets the метка of the node.NODE_ИКОНКА Sets the иконка of the node.NODE_ЗНАЧЕНИЕ Sets the значение of the node.

значение The actual значение you intend to pass.

Установка значений свойств иерархического дерева.

PROCEDURE SET_TREE_PROPERTY

(имя_метки VARCHAR2,

property NUMBER,

значение NUMBER);

PROCEDURE SET_TREE_PROPERTY

(имя_метки VARCHAR2,

property NUMBER,

значение VARCHAR2);

PROCEDURE SET_TREE_PROPERTY

(имя_метки VARCHAR2,

property NUMBER,

значение RECORDGROUP);

PROCEDURE SET_TREE_PROPERTY

(id_метки ITEM,

property NUMBER,

значение NUMBER);

PROCEDURE SET_TREE_PROPERTY

(id_метки ITEM,

property NUMBER,

значение VARCHAR2);

PROCEDURE SET_TREE_PROPERTY

(id_метки ITEM,

property NUMBER,

значение RECORDGROUP);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

property Specify one of the following properties:RECORD_GROUP Replaces the data set of the hierarchical tree with a record group and causes it to display.QUERY_TEXT Replaces the data set of the hierarchical tree with an SQL query and causes it to display.ALLOW_EMPTY_BRANCHES Possible значениеs are PROPERTY_TRUE and PROPERTY_FALSE.

значение Specify the значение appropriate to the property you are setting: PROPERTY_TRUE The property is to be set to the TRUE состояние.PROPERTY_FALSE The property is to be set to the FALSE состояние.

Спецефицирует выбранную вершину.

PROCEDURE SET_TREE_SELECTION

(имя_метки VARCHAR2,

node NODE,

selection_type NUMBER);

PROCEDURE SET_TREE_SELECTION

(id_метки ITEM,

node NODE,

selection_type NUMBER);

Built-in Type unrestricted procedure

Enter Query Mode no

Параметры

имя_метки Спецефицирует the name of the object created at design time. The data type of the name is VARCHAR2 string.

node Спецефицирует a valid node.

selection_type Спецефицирует the type of selection.SELECT_ON Selects the node.SELECT_OFF Deselects the node.SELECT_TOGGLE Toggles the selection состояние of the node.