Íà ãëàâíóþ ↑

Îãëàâëåíèå

Ââåäåíèå

Ôóíêöèè

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

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

Ïðèìåð 1:

	stdcall [tl_node_get_data], tree1

	pop eax

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

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

Ïðèìåð 2:

	NODE_SIZE equ 200

	node_data rb NODE_SIZE

.........

push ecx esi edi

	stdcall [tl_node_get_data], tree1

	pop esi

	mov edi,node_data

	mov ecx,NODE_SIZE

	cld

	rep movsb

pop edi esi ecx

ãäå: 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

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

	push dword tree1

	push dword 0

	call dword[tl_node_poi_get_info]

	pop esi

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

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

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

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

tl_node_poi_get_next_info

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

	push tree1

	push esi

	call dword[tl_node_poi_get_next_info]

	pop esi ;ïåðåõîäèì ê ñëåäóùåìó óçëó

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

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

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

tl_node_poi_get_data

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

	push dword tree1

	push dword esi

	call dword[tl_node_poi_get_data]

	pop eax ;ïîëó÷àåì äàííûå óçëà

ãäå: 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

.........

	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

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

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

	MEM_SIZE equ 5000

	node_data rb MEM_SIZE

.........

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

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

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

.........

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

	stdcall dword[tl_get_mem_size], node_data, tree1

	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_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 - óêàçàòåëü íà èçîáðàæåíèÿ ñ èêîíêàìè óçëîâ. Ôîðìàò èçîáðàæåíèÿ òàêîé æå êàê è â ñèñò. ô. 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_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 âñå óçëû îäíîãî óðîâíÿ).

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