Íà ãëàâíóþ ↑

Îãëàâëåíèå

Ââåäåíèå

Ôóíêöèè

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

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

	stdcall dword[tl_node_add], tree1,0x10002,data_buffer

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

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

tl_node_set_data

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

tl_node_get_data

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

Ïðèìåð 1:

	stdcall [tl_node_get_data], tree1

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

 eax - óêàçàòåëü íà äûííûå óçëà.

Ïðèìåð 2:

	NODE_SIZE equ 200

	node_data rb NODE_SIZE

.........

push eax ecx esi edi

	stdcall [tl_node_get_data], tree1

	mov esi,eax

	mov edi,node_data

	mov ecx,NODE_SIZE

	cld

	rep movsb

pop edi esi ecx eax

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

 NODE_SIZE - ðàçìåð äûííûõ óçëà;

 node_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

Áåðåò âíóòðåííèé óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ óçåë. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

	stdcall dword[tl_node_poi_get_info], tree1, 0

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

0 - ïîçèöèÿ óçëà, ñ êîòîðîãî áåðåòñÿ óêàçàòåëü;

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

Çàìå÷àíèå. Åñëè óçåë ñ óêàçàííûì èíäåêñîì íå íàéäåí, â óêàçàòåëå âîçâðàùàåòñÿ 0.

tl_node_poi_get_next_info

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

	stdcall dword[tl_node_poi_get_next_info], tree1, eax

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

eax - äî âûçîâà ôóíêöèè óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ óçåë, ïîñëå âûçîâà óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ ñëåäóùèé óçåë â öåïè.

Çàìå÷àíèå. Åñëè ñëåäóùèé óçåë íå íàéäåí, â óêàçàòåëå âîçâðàùàåòñÿ 0.

tl_node_poi_get_data

Áåðåò óêàçàòåëü íà äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) èç óçëà óêàçàííîãî â óêàçàòåëå. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:

	stdcall dword[tl_node_poi_get_data], tree1,esi

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

esi - óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ óçåë;

eax - óêàçàòåëü íà äàííûå óçëà, îïèñàííîãî â esi.

Óêàçàòåëü, âîçâðàùàåìûé ôóíêöèåé tl_node_poi_get_data àíàëîãè÷åí óêàçàòåëþ âîçâðàùàåìîìó ôóíêöèåé tl_node_get_data. Îòëè÷èå ôóíêöèé â òîì, ÷òî 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

.........

	stdcall dword[tl_save_mem], tree1, 0, node_data, MEM_SIZE

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

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

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

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

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

tl_load_mem

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

	MEM_SIZE equ 5000

	node_data rb MEM_SIZE

.........

	stdcall dword[tl_load_mem], tree1, 0, node_data, MEM_SIZE

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

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

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

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

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

tl_get_mem_size

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

 Ýòó ôóíêöèþ ìîæíî èñïîëüçîâàòü ïåðåä ñîõðàíåíèåì íà äèñê, äëÿ ïîëó÷åíèÿ òî÷íîãî ðàçìåðà ñîõðàíÿåìûõ äàííûõ. Ïðèìåð:

	MEM_SIZE equ 5000

	node_data rb MEM_SIZE

.........

	;ñîõðàíÿåì äàííûå â 'node_data'

	stdcall dword[tl_save_mem], tree1, 0, node_data, MEM_SIZE

	pop eax ;êîä îøèáêè

.........

	;ïîëó÷àåì ðàçìåð äàííûõ â 'node_data'

	stdcall dword[tl_get_mem_size], tree1, node_data

	pop ecx ;ðàçìåð äàííûõ, äîëæåí áûòü <= 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_scroll,on_press

{

.box_left    dd box_l

.box_top     dd box_t

.box_width   dd box_w

.box_height  dd box_h

.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

.tim_undo    dd 0

.cur_pos     dd 0

.col_bkg     dd col_bkg

.col_zag     dd col_zag

.col_txt     dd col_txt

.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_scroll    dd p_scroll

.on_press    dd on_press

}

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

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

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

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

data_img - óêàçàòåëü íà èçîáðàæåíèÿ ñ èêîíêàìè óçëîâ. Ôîðìàò èçîáðàæåíèÿ òàêîé æå êàê è â ñèñò. ô. 7: BBGGRRBBGGRR....

img_cx - øèðèíà îäíîé èêîíêè.

img_cy - âûñîòà îäíîé èêîíêè.

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

col_bkg - öâåò ôîíà.

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

col_txt - öâåò òåêñòà.

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

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

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

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 âñå óçëû îäíîãî óðîâíÿ).

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