Subversion Repositories Kolibri OS

Rev

Rev 1374 | Rev 1634 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. <html>
  2. <head>
  3. <title>ýëåìåíò Tree List</title>
  4. <meta http-equiv="content-type" content="text/html; charset=WINDOWS-1251">
  5. <link href="../style.css" type=text/css rel=stylesheet>
  6. </head>
  7. <body>
  8. <p><a href="../box_lib.htm">Íà ãëàâíóþ &uarr;</a></p>
  9. <h1>Îãëàâëåíèå</h1>
  10. <p><a href="#vveden">Ââåäåíèå</a></p>
  11. <p><a href="#funct">Ôóíêöèè</a></p>
  12. <ul>
  13. <li><a href="#fun_init">tl_data_init</a></li>
  14. <li><a href="#fun_clear1">tl_data_clear</a></li>
  15. <li><a href="#fun_clear2">tl_info_clear</a></li>
  16. <li><a href="#fun_key">tl_key</a></li>
  17. <li><a href="#fun_mouse">tl_mouse</a></li>
  18. <li><a href="#fun_draw">tl_draw</a></li>
  19. <li><a href="#fun_undo">tl_info_undo</a></li>
  20. <li><a href="#fun_redo">tl_info_redo</a></li>
  21. <li><a href="#fun_add">tl_node_add</a></li>
  22. <li><a href="#fun_set_d">tl_node_set_data</a></li>
  23. <li><a href="#fun_get_d">tl_node_get_data</a></li>
  24. <li><a href="#fun_delete">tl_node_delete</a></li>
  25. <li><a href="#fun_cur_b">tl_cur_beg</a></li>
  26. <li><a href="#fun_cur_n">tl_cur_next</a></li>
  27. <li><a href="#fun_cur_p">tl_cur_perv</a></li>
  28. <li><a href="#fun_clo_opn">tl_node_close_open</a></li>
  29. <li><a href="#fun_lev_i">tl_node_lev_inc</a></li>
  30. <li><a href="#fun_lev_d">tl_node_lev_dec</a></li>
  31. <li><a href="#fun_mov_u">tl_node_move_up</a></li>
  32. <li><a href="#fun_mov_d">tl_node_move_down</a></li>
  33. <li>tl_node_poi_get_info</li>
  34. <li>tl_node_poi_get_next_info</li>
  35. <li>tl_node_poi_get_data</li>
  36. <li><a href="#fun_sme">tl_save_mem</a></li>
  37. <li><a href="#fun_lme">tl_load_mem</a></li>
  38. <li><a href="#fun_gme">tl_get_mem_size</a></li>
  39. <li><a href="#version">version_tree_list</a></li>
  40. </ul>
  41. <p><a href="#struc_tree_list">Ñòðóêòóðà tree_list</a></p>
  42. <p><a href="#tree_list_styles">Ñòèëè ýëåìåíòà</a></p>
  43.  
  44. <h1><a name="vveden">Ââåäåíèå</a></h1>
  45. <p>Âíåøíèé âèä ýëåìåíòà óïðàâëåíèÿ TreeList:</p>
  46. <p><img src="window_tree_list.png"></p>
  47. <p>Ðèñ. 1. Îêíî ïðîãðàììû ñ ýëåìåíòîì TreeList</p>
  48.  
  49. <h1><a name="funct">Ôóíêöèè</a></h1>
  50.  
  51. <h2><a name="fun_init">tl_data_init</a></h2>
  52. <p>Êîíñòðóêòîð ýëåìåíòà, íóæíî âûçûâàòü ïåðåä èñïîëüçîâàíèåì ýëåìåíòà äëÿ âûäåëåíèÿ ïàìÿòè è äðóãèõ íàñòðîåê.</p>
  53. <h2><a name="fun_clear1">tl_data_clear</a></h2>
  54. <p>Äåñòðóêòîð ýëåìåíòà, ÷èñòèò ïàìÿòü ïî óêàçàòåëÿì: <b>data_info</b>, <b>data_nodes</b>, <b>data_img</b> è <b>data_img_sys</b>. Åñëè â ïðîãðàììå èñïîëüçóåòñÿ <i>íåñêîëüêî ýëåìåíòîâ ñ îäèíàêîâûìè èêîíêàìè</i>, òî óêàçàòåëè data_img è data_img_sys íóæíî ïðèðàâíÿòü ê 0 â äðóãèõ ýëåìåíòàõ, òàê ÷òî-áû ïðè âûçîâå äåñòðóêòîðîâ íå áûëî ïîâòîðíîãî óäàëåíèÿ îäíèõ è òåõ æå èêîíîê.</p>
  55.  
  56. <h2><a name="fun_clear2">tl_info_clear</a></h2>
  57. <p>Î÷èñòêà ñïèñêà îò âñåõ óçëîâ. Ýòî äåéñòâèå íåëüçÿ îòìåíèòü ôóíêöèåé <b>tl_info_undo</b>.</p>
  58.  
  59. <h2><a name="fun_key">tl_key</a></h2>
  60. <p>Ôóíêöèÿ êîòîðóþ íóæíî âûçûâàòü ïðè íàæàòèè íà êëàâèàòóðó.
  61.  Êíîïêè, êîòîðûå íå äîñòóïíû åñëè åñòü ñòèëü <i>tl_key_no_edit</i>: [<b>Enter</b>], [<b>Delete</b>], [<b>&larr;</b>], [<b>&rarr;</b>].
  62.  Âñåãäà äîñòóïíû: [<b>&uarr;</b>], [<b>&darr;</b>], [<b>Page Up</b>], [<b>Page Dn</b>], [<b>Space</b>].
  63.  Ôóíêöèÿ ïðîâåðÿåò âêëþ÷åí ëè ðåæèì scan êîäîâ, è â ñëó÷àå íåîáõîäèìîñòè ñàìà ïðåîáðàçóåò êîäû.</p>
  64.  
  65. <h2><a name="fun_mouse">tl_mouse</a></h2>
  66. <p>Ôóíêöèÿ äëÿ ñîáûòèé îò ìûøè.</p>
  67.  
  68. <h2><a name="fun_draw">tl_draw</a></h2>
  69. <p>Ïîëíàÿ ïåðåðèñîâêà îêíà ýëåìåíòà.</p>
  70.  
  71. <h2><a name="fun_undo">tl_info_undo</a></h2>
  72. <p>Îòìåíÿåò äîáàâëåíèå óçëîâ. Äåéñòâóåò òîëüêî íà âåñü óçåë öåëèêîì, íå ó÷èòûâàÿ èçìåíåíèÿ âíóòðè óçëîâ. Ò. å. íåëüçÿ îòìåíèòü äåéñòâèÿ âûïîëíåííûå íàïðèìåð ôóíêöèÿìè: <b>tl_node_set_data</b>, <b>tl_node_lev_inc</b> è èì ïîäîáíûì.</p>
  73.  
  74. <h2><a name="fun_redo">tl_info_redo</a></h2>
  75. <p>Ïîâòîð îòìåíåííûõ äåéñòâèé. Îáðàòíàÿ ôóíêöèÿ ïî îòíîøåíèþ ê <b>tl_info_undo</b>.</p>
  76.  
  77. <h2><a name="fun_add">tl_node_add</a></h2>
  78. <p>Äîáàâëÿåò óçåë, â ïîçèöèþ óêàçàííóþ êóðñîðîì. Ïðèìåð äîáàâëåíèÿ óçëà:</p>
  79. <pre>  push dword tree1
  80.   push dword 0x10002
  81.   push dword data_buffer
  82.   call dword[tl_node_add]</pre>
  83. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list;
  84.  <b>0x10002</b> - ïàðàìåòðû óçëà (ñòàðøèå áàéòû 0x0001 - èíäåêñ èêîíêè, îòîáðàæàåìîé âîçëå óçëà; ìåíüøèé áàéò 0x02 - óðîâåíü âëîæåíîñòè óçëà); <b>data_buffer</b> - óêàçàòåëü íà äûííûå, äîáàâëÿåìûå â óçåë.</p>
  85.  
  86. <h2><a name="fun_set_d">tl_node_set_data</a></h2>
  87. <p>Óñòàíàâëèâàåò íîâûå äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) â óçåë ïîä êóðñîðîì.</p>
  88.  
  89. <h2><a name="fun_get_d">tl_node_get_data</a></h2>
  90. <p>Áåðåò óêàçàòåëü íà äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) èç óçëà ïîä êóðñîðîì.</p>
  91. <p>Ïðèìåð 1:</p>
  92. <pre>   stdcall [tl_node_get_data], tree1
  93.         pop eax</pre>
  94. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list;
  95.  <b>eax</b> - óêàçàòåëü íà äûííûå óçëà.</p>
  96.  
  97. <p>Ïðèìåð 2:</p>
  98. <pre>   NODE_SIZE equ 200
  99.         node_data rb NODE_SIZE
  100. .........
  101. push ecx esi edi
  102.         stdcall [tl_node_get_data], tree1
  103.         pop esi
  104.         mov edi,node_data
  105.         mov ecx,NODE_SIZE
  106.         cld
  107.         rep movsb
  108. pop edi esi ecx</pre>
  109. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list;
  110.  <b>NODE_SIZE</b> - ðàçìåð äûííûõ óçëà;
  111.  <b>node_data</b> - êîïèÿ íà äûííûõ óçëà.</p>
  112.  
  113. <h2><a name="fun_delete">tl_node_delete</a></h2>
  114. <p>Óäàëÿåò óçåë, íî íå îêîí÷àòåëüíî, ïðè íåîáõîäèìîñòè óçåë ìîæíî âåðíóòü ôóíêöèåé <b>tl_info_undo</b>.</p>
  115.  
  116. <h2><a name="fun_cur_b">tl_cur_beg</a></h2>
  117. <p>Ñòàâèò êóðñîð â íà÷àëî ñïèñêà, ïåðåìàòûâàåò ñêðîëëèíã åñëè íóæíî.</p>
  118.  
  119. <h2><a name="fun_cur_n">tl_cur_next</a></h2>
  120. <p>Ïåðåíîñèò êóðñîð íà îäíó ïîçèöèþ íèæå.</p>
  121.  
  122. <h2><a name="fun_cur_p">tl_cur_perv</a></h2>
  123. <p>Ïåðåíîñèò êóðñîð íà îäíó ïîçèöèþ âûøå.</p>
  124.  
  125. <h2><a name="fun_clo_opn">tl_node_close_open</a></h2>
  126. <p>Îòêðûâàåò èëè çàêðûâàåò ðîäèòåëüñêèé óçåë. Åñëè ó óçëà íåò äî÷åðíèõ ýëåìåíòîâ,
  127.  òî íè÷åãî íå äåëàåò. Àâòîìàòè÷åñêè ïåðåðèñîâûâàåò îêíî åñëè ñîñòîÿíèå óçëà èçìåíèëîñü.</p>
  128.  
  129. <h2><a name="fun_lev_i">tl_node_lev_inc</a></h2>
  130. <p>Äîáàâèòü óðîâåíü óçëà ïîä êóðñîðîì. Äåëàåò óçåë äî÷åðíèì.</p>
  131.  
  132. <h2><a name="fun_lev_d">tl_node_lev_dec</a></h2>
  133. <p>Óìåíüøàåò óðîâåíü óçëà ïîä êóðñîðîì. Äåëàåò óçåë ðîäèòåëüñêèì.</p>
  134.  
  135. <h2><a name="fun_mov_u">tl_node_move_up</a></h2>
  136. <p>Ïåðåìåùàåò ââåðõ óçåë ïîä êóðñîðîì. Âìåñòå ñ óçëîì äâèãàåòñÿ òàêæå è êóðñîð. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:</p>
  137. <pre>  push dword tree1
  138.   call dword[tl_node_move_up] ;ïåðåìåñòèòü óçåë</pre>
  139. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list</p>
  140.  
  141. <h2><a name="fun_mov_d">tl_node_move_down</a></h2>
  142. <p>Ïåðåìåùàåò âíèç óçåë ïîä êóðñîðîì. Âìåñòå ñ óçëîì äâèãàåòñÿ òàêæå è êóðñîð. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:</p>
  143. <pre>  push dword tree1
  144.   call dword[tl_node_move_down] ;ïåðåìåñòèòü óçåë</pre>
  145. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list</p>
  146.  
  147. <h2>tl_node_poi_get_info</h2>
  148. <p>Áåðåò âíóòðåííèé óêàçàòåëü íà ñòðóêòóðó îïèñûâàþùóþ óçåë.</p>
  149. <h2>tl_node_poi_get_next_info</h2>
  150. <p>Áåðåò óêàçàòåëü íà ñëåäóþùèé ýëåìåíò â öåïè, áåç ó÷åòà îòêðûòèÿ/çàêðûòèÿ äî÷åðíèõ óçëîâ.</p>
  151. <h2>tl_node_poi_get_data</h2>
  152. <p>Áåðåò óêàçàòåëü íà äàííûå (ïîëüçîâàòåëüñêèå è ïîäïèñü) èç óçëà óêàçàííîãî â óêàçàòåëå.</p>
  153.  
  154. <p>Ôóíêöèÿìè tl_node_poi_get_info, tl_node_poi_get_next_info è tl_node_poi_get_data ìîæíî ñ÷èòûâàòü èíôîðìàöèþ î óçëàõ ýëåìåíòà, ïðè ýòîì íå ìåíÿÿ òåêóùåãî ïîëîæåíèÿ êóðñîðà. Ò. å. ìîæíî îðãàíèçîâàòü äîñòóï ê äàíûì ýëåìåíòà â &quot;ôîíîâîì ðåæèìå&quot;.</p>
  155.  
  156. <h2><a name="fun_sme">tl_save_mem</a></h2>
  157. <p>Ñîõðàíÿåò èíôîðìàöèþ îá óçëàõ ýëåìåíòà â ïàìÿòü. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:</p>
  158. <pre>  MEM_SIZE equ 5000
  159.   node_data rb MEM_SIZE
  160. .........
  161.   push dword tree1
  162.   push dword 0
  163.   push dword node_data
  164.   push dword MEM_SIZE
  165.   call dword[tl_save_mem]
  166.   pop eax</pre>
  167. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list;
  168.  <b>0</b> - îïöèÿ ñîõðàíåíèÿ â íà÷àëî áëîêà ïàìÿòè (åñëè = 1, òî äîáàâëÿåò ýëåìåíò ïîñëå äðóãèõ ñîõðàíåííûõ ðàíåå);
  169.  <b>node_data</b> - óêàçàòåëü íà áëîê ïàìÿòè;
  170.  <b>MEM_SIZE</b> - ðàçìåð áëîêà ïàìÿòè äëÿ ñîõðàíåíèÿ.
  171.  ðåãèñòð <b>eax</b> ïèøåòñÿ çíà÷åíèå 0 èëè çàïèñûâàþòñÿ êîäû îøèáîê ñîõðàíåíèÿ.</p>
  172.  
  173. <h2><a name="fun_lme">tl_load_mem</a></h2>
  174. <p>Çàãðóæàåò èíôîðìàöèþ îá óçëàõ ýëåìåíòà èç ïàìÿòè. Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè:</p>
  175. <pre>  MEM_SIZE equ 5000
  176.   node_data rb MEM_SIZE
  177. .........
  178.   push dword tree1
  179.   push dword 0
  180.   push dword node_data
  181.   push dword MEM_SIZE
  182.   call dword[tl_load_mem]
  183.   pop eax</pre>
  184. <p>ãäå: <b>tree1</b> - ñòðóêòóðà tree_list;
  185.  <b>0</b> - èíäåêñ ñ÷èòûâàåìîãî ýëåìåíòà;
  186.  <b>node_data</b> - óêàçàòåëü íà áëîê ïàìÿòè;
  187.  <b>MEM_SIZE</b> - ðàçìåð áëîêà ïàìÿòè äëÿ ñîõðàíåíèÿ.
  188.  ðåãèñòð <b>eax</b> ïèøåòñÿ çíà÷åíèå 0 èëè çàïèñûâàþòñÿ êîäû îøèáîê ñ÷èòûâàíèÿ.</p>
  189.  
  190. <h2><a name="fun_gme">tl_get_mem_size</a></h2>
  191. <p>Âû÷èñëÿåò ðàçìåð áëîêà ïàìÿòè (â êîòîðûé áûëè ðàíüøå ñîõðàíåíû ýëåìåíòû).
  192.  Ýòó ôóíêöèþ ìîæíî èñïîëüçîâàòü ïåðåä ñîõðàíåíèåì íà äèñê, äëÿ ïîëó÷åíèÿ òî÷íîãî
  193.  ðàçìåðà ñîõðàíÿåìûõ äàííûõ.</p>
  194.  
  195. <h2><a name="version">version_tree_list</a></h2>
  196. <p>Âåðñèÿ ýëåìåíòà</p>
  197.  
  198. <h1><a name="struc_tree_list">Ñòðóêòóðà tree_list</a></h1>
  199. <pre>struc tree_list info_size,info_max_count,style, img_cx,img_cy,\
  200.     col_bkg,col_zag,col_txt, box_l,box_t,box_w,box_h, capt_cy,info_capt_offs,\
  201.     info_capt_len,el_focus, p_scrol,on_press {
  202.   .data_info  dd 0
  203.   .info_size  dw info_size
  204.   .info_max_count dd info_max_count
  205.   .style      dd style
  206.   .data_nodes dd 0
  207.   .data_img   dd 0
  208.   .img_cx     dw img_cx
  209.   .img_cy     dw img_cy
  210.   .data_img_sys dd 0
  211.   .ch_tim     dd 0
  212.   .ls_tim     dd 0
  213.   .tim_undo   dd 0
  214.   .cur_pos    dd 0
  215.   .col_bkg    dd col_bkg
  216.   .col_zag    dd col_zag
  217.   .col_txt    dd col_txt
  218.   .box_left   dd box_l
  219.   .box_top    dd box_t
  220.   .box_width  dd box_w
  221.   .box_height dd box_h
  222.   .capt_cy    dw capt_cy
  223.   .info_capt_offs dw info_capt_offs
  224.   .info_capt_len  dw info_capt_len
  225.   .el_focus    dd el_focus
  226.   .p_scrol     dd p_scrol
  227.   rb 4
  228.   .on_activate dd 0
  229.   .on_press    dd on_press
  230. }</pre>
  231. <p><b>info_size</b> - êîëè÷åñòâî áàéò, êîòîðîå áóäåò âûäåëåíî äëÿ êàæäîãî óçëà. ×àñòü ýòîé ïàìÿòè ïîëüçîâàòåëü ìîæåò èñïîëüçîâàòü äëÿ ñâîèõ öåëåé (ðåãóëèðóåòñÿ ÷åðåç <i>info_capt_offs</i> è <i>info_capt_len</i> ñì. ðèñ. 2) à îñòàëüíàÿ ÷àñòü áóäåò èñïîëüçîâàíà êàê ïîäïèñü óçëà.</p>
  232. <p><b>info_max_count</b> - ìàêñèìàëüíîå êîëè÷åñòâî óçëîâ, êîòîðûå ìîæíî äîáàâèòü â ýëåìåíò.</p>
  233. <p><b>style</b> - ñòèëè ýëåìåíòà.</p>
  234. <p><b>data_nodes</b> - óêàçàòåëü íà âíóòðåííèå ñòðóêòóðû óçëîâ (<i>TreeList</i>).</p>
  235. <p><b>data_img</b> - óêàçàòåëü íà èçîáðàæåíèÿ ñ èêîíêàìè óçëîâ.</p>
  236. <p><b>data_img_sys</b> - óêàçàòåëü íà ñèñòåìíûå èçîáðàæåíèÿ (êóðñîð, ïëþñèêè, ëèíèè, ... âñå êðîìå èêîíîê óçëîâ).</p>
  237. <p><b>capt_cy</b> - âûñîòà ñòðîêè äëÿ ïîäïèñè ââåðõó ýëåìåíòà, åñëè ìåíüøå 9 ïîäïèñü íå âûâîäèòñÿ.</p>
  238. <p><b>info_capt_len</b> - äëèííà òåêñòà äëÿ ïîäïèñè. Åñëè ðàâíî 0, òî äëèííà ñ÷èòàåòñÿ òàê: <i>info_size - info_capt_offs</i>.</p>
  239. <p><b>p_scrol</b> - óêàçàòåëü íà ñòðóêòóðó ñêðîëëèíãà, ñâÿçàííîãî ñ äàííûì ýëåìåíòîì.</p>
  240. <p><b>on_press</b> - óêàçàòåëü íà ôóíêöèþ, êîòîðàÿ áóäåò âûçâàíà ïðè íàæèòèè [<b>Enter</b>]. Åñëè óêàçàòåëü ðàâåí 0 òî íè÷åãî íå áóäåò âûçûâàòñÿ.</p>
  241.  
  242. <p><img src="info_size.png"></p>
  243. <p>Ðèñ. 2. Ïàðàìåòðû <i>info_size</i>, <i>info_capt_offs</i> è <i>info_capt_len</i> â óçëå</p>
  244.  
  245. <p>Ïðèìåð ñîçäàíèÿ ñòðóêòóðû:</p>
  246. <pre>tree1 tree_list 24,500, tl_draw_par_line+tl_list_box_mode, 16,16,\
  247.     0x8080ff,0x0000ff,0xffffff, 10,35,200-16,285, 14,4,0,\
  248.     el_focus, wScr,fun_on_enter</pre>
  249.  
  250. <h1><a name="tree_list_styles">Ñòèëè ýëåìåíòà</a></h1>
  251. <h2>tl_key_no_edit</h2>
  252. <p>Ýëåìåíò íåëüçÿ ðåäàêòèðîâàòü íà êëàâèàòóðå (èçìåíÿòü óðîâíè, óäàëÿòü). Ñòàâüòå ýòîò ñòèëü åñëè íóæíî ñîçäàòü ýëåìåíò òîëüêî äëÿ ïðîñìîòðà äàííûõ.</p>
  253. <h2>tl_draw_par_line</h2>
  254. <p>Ðèñîâàòü ëèíèè ê ðîäèòåëüñêîìó óçëó.</p>
  255. <h2>tl_list_box_mode</h2>
  256. <p>Ñòèëü íå îòîáðàæàåò óðîâíè (êàê â ListBox âñå óçëû îäíîãî óðîâíÿ).</p>
  257.  
  258. <hr>
  259. <p>Äîêóìåíòàöèÿ îáíîâëÿëàñü ïîñëåäíèé ðàç 08.09.10.</p>
  260. </body>
  261. </html>