Îãëàâëåíèå

Ââåäåíèå

Ôóíêöèè

tl_data_init

tl_data_clear

tl_info_clear

tl_key

tl_mouse

tl_draw

tl_info_undo

tl_info_redo

tl_node_add

tl_node_set_data

tl_node_get_data

tl_node_delete

tl_cur_beg

tl_cur_next

tl_cur_perv

tl_node_close_open

tl_node_lev_inc

tl_node_lev_dec

tl_node_move_up

tl_node_move_down

tl_node_poi_get_info

tl_node_poi_get_next_info

tl_node_poi_get_data

tl_save_mem

tl_load_mem

tl_get_mem_size

version_tree_list

Ñòðóêòóðà tree_list

Ñòèëè ýëåìåíòà

Ââåäåíèå

Âíåøíèé âèä ýëåìåíòà óïðàâëåíèÿ TreeList:

Ðèñ. 1. Îêíî ïðîãðàììû ñ ýëåìåíòîì TreeList

Ôóíêöèè

tl_data_init

Êîíñòðóêòîð ýëåìåíòà, íóæíî âûçûâàòü ïåðåä èñïîëüçîâàíèåì ýëåìåíòà äëÿ âûäåëåíèÿ ïàìÿòè è äðóãèõ íàñòðîåê.

tl_data_clear

Äåñòðóêòîð ýëåìåíòà, ÷èñòèò ïàìÿòü ïî óêàçàòåëÿì: data_info, data_nodes, data_img è data_img_sys. Åñëè â ïðîãðàììå èñïîëüçóåòñÿ íåñêîëüêî ýëåìåíòîâ ñ îäèíàêîâûìè èêîíêàìè, òî óêàçàòåëè data_img è data_img_sys íóæíî ïðèðàâíÿòü ê 0 â äðóãèõ ýëåìåíòàõ, òàê ÷òî-áû ïðè âûçîâå äåñòðóêòîðîâ íå áûëî ïîâòîðíîãî óäàëåíèÿ îäíèõ è òåõ æå èêîíîê.

tl_info_clear

Î÷èñòêà ñïèñêà îò âñåõ óçëîâ. Ýòî äåéñòâèå íåëüçÿ îòìåíèòü ôóíêöèåé tl_info_undo.

tl_key

Ôóíêöèÿ êîòîðóþ íóæíî âûçûâàòü ïðè íàæàòèè íà êëàâèàòóðó.

 Êíîïêè, êîòîðûå íå äîñòóïíû åñëè åñòü ñòèëü tl_key_no_edit: [Enter], [Delete], [←], [→].

 Âñåãäà äîñòóïíû: [↑], [↓], [Page Up], [Page Dn], [Space].

 Ôóíêöèÿ ïðîâåðÿåò âêëþ÷åí ëè ðåæèì scan êîäîâ, è â ñëó÷àå íåîáõîäèìîñòè ñàìà ïðåîáðàçóåò êîäû.

tl_mouse

Ôóíêöèÿ äëÿ ñîáûòèé îò ìûøè.

tl_draw

Ïîëíàÿ ïåðåðèñîâêà îêíà ýëåìåíòà.

tl_info_undo

Îòìåíÿåò äîáàâëåíèå óçëîâ. Äåéñòâóåò òîëüêî íà âåñü óçåë öåëèêîì, íå ó÷èòûâàÿ èçìåíåíèÿ âíóòðè óçëîâ. Ò. å. íåëüçÿ îòìåíèòü äåéñòâèÿ âûïîëíåííûå íàïðèìåð ôóíêöèÿìè: tl_node_set_data, tl_node_lev_inc è èì ïîäîáíûì.

tl_info_redo

Ïîâòîð îòìåíåííûõ äåéñòâèé. Îáðàòíàÿ ôóíêöèÿ ïî îòíîøåíèþ ê tl_info_undo.

tl_node_add

Äîáàâëÿåò óçåë, â ïîçèöèþ óêàçàííóþ êóðñîðîì. Ïðèìåð äîáàâëåíèÿ óçëà:

  push dword tree1

  push dword 0x10002

  push dword data_buffer

  call dword[tl_node_add]

ãäå: tree1 - ñòðóêòóðà tree_list;

 0x10002 - ïàðàìåòðû óçëà (ñòàðøèå áàéòû 0x0001 - èíäåêñ èêîíêè, îòîáðàæàåìîé âîçëå óçëà; ìåíüøèé áàéò 0x02 - óðîâåíü âëîæåíîñòè óçëà); data_buffer - óêàçàòåëü íà äûííûå, äîáàâëÿåìûå â óçåë.

tl_node_set_data

Óñòàíàâëèâàåò íîâûå äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) â óçåë ïîä êóðñîðîì.

tl_node_get_data

Áåðåò óêàçàòåëü íà äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) èç óçëà ïîä êóðñîðîì.

tl_node_delete

Óäàëÿåò óçåë, íî íå îêîí÷àòåëüíî, ïðè íåîáõîäèìîñòè óçåë ìîæíî âåðíóòü ôóíêöèåé tl_info_undo.

tl_cur_beg

Ñòàâèò êóðñîð â íà÷àëî ñïèñêà, ïåðåìàòûâàåò ñêðîëëèíã åñëè íóæíî.

tl_cur_next

Ïåðåíîñèò êóðñîð íèæå.

tl_cur_perv

Ïåðåíîñèò êóðñîð âûøå.

tl_node_close_open

Îòêðûâàåò èëè çàêðûâàåò ðîäèòåëüñêèé óçåë. Åñëè ó óçëà íåò äî÷åðíèõ ýëåìåíòîâ,

 òî íè÷åãî íå äåëàåò. Àâòîìàòè÷åñêè ïåðåðèñîâûâàåò îêíî åñëè ñîñòîÿíèå óçëà èçìåíèëîñü.

tl_node_lev_inc

Äîáàâèòü óðîâåíü óçëà ïîä êóðñîðîì. Äåëàåò óçåë äî÷åðíèì.

tl_node_lev_dec

Óìåíüøàåò óðîâåíü óçëà ïîä êóðñîðîì. Äåëàåò óçåë ðîäèòåëüñêèì.

tl_node_move_up

Ïåðåìåùàåò ââåðõ óçåë ïîä êóðñîðîì. Âìåñòå ñ óçëîì äâèãàåòñÿ òàêæå è êóðñîð. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

  push dword tree1

  call dword[tl_node_move_up] ;ïåðåìåñòèòü óçåë

ãäå: tree1 - ñòðóêòóðà tree_list

tl_node_move_down

Ïåðåìåùàåò âíèç óçåë ïîä êóðñîðîì. Âìåñòå ñ óçëîì äâèãàåòñÿ òàêæå è êóðñîð. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

  push dword tree1

  call dword[tl_node_move_down] ;ïåðåìåñòèòü óçåë

ãäå: tree1 - ñòðóêòóðà tree_list

tl_node_poi_get_info

Áåðåò âíóòðåííèé óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ óçåë.

tl_node_poi_get_next_info

Áåðåò óêàçàòåëü íà ñëåäóþùèé ýëåìåíò â öåïè, áåç ó÷åòà îòêðûòèÿ/çàêðûòèÿ äî÷åðíèõ óçëîâ.

tl_node_poi_get_data

Áåðåò óêàçàòåëü íà äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) èç óçëà óêàçàííîãî â óêàçàòåëå.

Ôóíêöèÿìè tl_node_poi_get_info, tl_node_poi_get_next_info è tl_node_poi_get_data ìîæíî ñ÷èòûâàòü èíôîðìàöèþ î óçëàõ ýëåìåíòà, ïðè ýòîì íå ìåíÿÿ òåêóùåãî ïîëîæåíèÿ êóðñîðà. Ò. å. ìîæíî îðãàíèçîâàòü äîñòóï ê äàíûì ýëåìåíòà â "ôîíîâîì ðåæèìå".

tl_save_mem

Ñîõðàíÿåò èíôîðìàöèþ îá óçëàõ ýëåìåíòà â ïàìÿòü. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

  MEM_SIZE equ 5000

  node_data rb MEM_SIZE

.........

  push dword tree1

  push dword 0

  push dword node_data

  push dword MEM_SIZE

  call dword[tl_save_mem]

  pop eax

ãäå: tree1 - ñòðóêòóðà tree_list;

 0 - îïöèÿ ñîõðàíåíèÿ â íà÷àëî áëîêà ïàìÿòè (åñëè = 1, òî äîáàâëÿåò ýëåìåíò ïîñëå äðóãèõ ñîõðàíåííûõ ðàíåå);

 node_data - óêàçàòåëü íà áëîê ïàìÿòè;

 MEM_SIZE - ðàçìåð áëîêà ïàìÿòè äëÿ ñîõðàíåíèÿ.

 ðåãèñòð eax ïèøåòñÿ çíà÷åíèå 0 èëè çàïèñûâàþòñÿ êîäû îøèáîê ñîõðàíåíèÿ.

tl_load_mem

Çàãðóæàåò èíôîðìàöèþ îá óçëàõ ýëåìåíòà èç ïàìÿòè. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

  MEM_SIZE equ 5000

  node_data rb MEM_SIZE

.........

  push dword tree1

  push dword 0

  push dword node_data

  push dword MEM_SIZE

  call dword[tl_load_mem]

  pop eax

ãäå: tree1 - ñòðóêòóðà tree_list;

 0 - èíäåêñ ñ÷èòûâàåìîãî ýëåìåíòà;

 node_data - óêàçàòåëü íà áëîê ïàìÿòè;

 MEM_SIZE - ðàçìåð áëîêà ïàìÿòè äëÿ ñîõðàíåíèÿ.

 ðåãèñòð eax ïèøåòñÿ çíà÷åíèå 0 èëè çàïèñûâàþòñÿ êîäû îøèáîê ñ÷èòûâàíèÿ.

tl_get_mem_size

Âû÷èñëÿåò ðàçìåð áëîêà ïàìÿòè (â êîòîðûé áûëè ðàíüøå ñîõðàíåíû ýëåìåíòû).

version_tree_list

Âåðñèÿ ýëåìåíòà

Ñòðóêòóðà tree_list

struc tree_list info_size,info_max_count,style, img_cx,img_cy,\

    col_bkg,col_zag,col_txt, box_l,box_t,box_w,box_h, capt_cy,info_capt_offs,\

    info_capt_len,el_focus, p_scrol,on_press {

  .data_info  dd 0

  .info_size  dw info_size

  .info_max_count dd info_max_count

  .style      dd style

  .data_nodes dd 0

  .data_img   dd 0

  .img_cx     dw img_cx

  .img_cy     dw img_cy

  .data_img_sys dd 0

  .ch_tim     dd 0

  .ls_tim     dd 0

  .tim_undo   dd 0

  .cur_pos    dd 0

  .col_bkg    dd col_bkg

  .col_zag    dd col_zag

  .col_txt    dd col_txt

  .box_left   dd box_l

  .box_top    dd box_t

  .box_width  dd box_w

  .box_height dd box_h

  .capt_cy    dw capt_cy

  .info_capt_offs dw info_capt_offs

  .info_capt_len  dw info_capt_len

  .el_focus    dd el_focus

  .p_scrol     dd p_scrol

  rb 4

  .on_activate dd 0

  .on_press    dd on_press

}

info_size - êîëè÷åñòâî áàéò, êîòîðîå áóäåò âûäåëåíî äëÿ êàæäîãî óçëà. ×àñòü ýòîé ïàìÿòè ïîëüçîâàòåëü ìîæåò èñïîëüçîâàòü äëÿ ñâîèõ öåëåé (ðåãóëèðóåòñÿ ÷åðåç info_capt_offs è info_capt_len ñì. ðèñ. 2) à îñòàëüíàÿ ÷àñòü áóäåò èñïîëüçîâàíà êàê ïîäïèñü óçëà.

info_max_count - ìàêñèìàëüíîå êîëè÷åñòâî óçëîâ, êîòîðûå ìîæíî äîáàâèòü â ýëåìåíò.

style - ñòèëè ýëåìåíòà.

data_nodes - óêàçàòåëü íà âíóòðåííèå ñòðóêòóðû óçëîâ (TreeList).

data_img - óêàçàòåëü íà èçîáðàæåíèÿ ñ èêîíêàìè óçëîâ.

data_img_sys - óêàçàòåëü íà ñèñòåìíûå èçîáðàæåíèÿ (êóðñîð, ïëþñèêè, ëèíèè, ... âñå êðîìå èêîíîê óçëîâ).

capt_cy - âûñîòà ñòðîêè äëÿ ïîäïèñè ââåðõó ýëåìåíòà, åñëè ìåíüøå 9 ïîäïèñü íå âûâîäèòñÿ.

info_capt_len - äëèííà òåêñòà äëÿ ïîäïèñè. Åñëè ðàâíî 0, òî äëèííà ñ÷èòàåòñÿ òàê: info_size - info_capt_offs.

p_scrol - óêàçàòåëü íà ñòðóêòóðó ñêðîëëèíãà, ñâÿçàííîãî ñ äàííûì ýëåìåíòîì.

on_press - óêàçàòåëü íà ôóíêöèþ, êîòîðàÿ áóäåò âûçâàíà ïðè íàæèòèè [Enter]. Åñëè óêàçàòåëü ðàâåí 0 òî íè÷åãî íå áóäåò âûçûâàòñÿ.

Ðèñ. 2. Ïàðàìåòðû info_size, info_capt_offs è info_capt_len â óçëå

Ïðèìåð ñîçäàíèÿ ñòðóêòóðû:

tree1 tree_list 24,500, tl_draw_par_line+tl_list_box_mode, 16,16,\

    0x8080ff,0x0000ff,0xffffff, 10,35,200-16,285, 14,4,0,\

    el_focus, wScr,fun_on_enter

Ñòèëè ýëåìåíòà

tl_key_no_edit

Ýëåìåíò íåëüçÿ ðåäàêòèðîâàòü íà êëàâèàòóðå (èçìåíÿòü óðîâíè, óäàëÿòü). Ñòàâüòå ýòîò ñòèëü åñëè íóæíî ñîçäàòü ýëåìåíò òîëüêî äëÿ ïðîñìîòðà äàííûõ.

tl_draw_par_line

Ðèñîâàòü ëèíèè ê ðîäèòåëüñêîìó óçëó.

tl_list_box_mode

Ñòèëü íå îòîáðàæàåò óðîâíè (êàê â ListBox âñå óçëû îäíîãî óðîâíÿ).

Äîêóìåíòàöèÿ îáíîâëÿëàñü ïîñëåäíèé ðàç 23.12.09.