arcadia 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (167) hide show
  1. data/README +126 -123
  2. data/arcadia.rb +770 -756
  3. data/base/a-contracts.rb +130 -93
  4. data/base/a-ext.rb +280 -280
  5. data/base/a-libs.rb +5 -11
  6. data/base/a-utils.rb +235 -44
  7. data/conf/arcadia.conf +20 -16
  8. data/conf/arcadia.init.rb +0 -0
  9. data/conf/arcadia.res.rb +74 -0
  10. data/ext/ae-complete-code/ae-complete-code.conf +0 -0
  11. data/ext/ae-complete-code/ae-complete-code.rb +80 -79
  12. data/ext/ae-debug/ae-debug.conf +0 -0
  13. data/ext/ae-debug/ae-debug.rb +2 -6
  14. data/ext/ae-debug/debug1.57.rb +0 -0
  15. data/ext/ae-doc-code/ae-doc-code.conf +15 -0
  16. data/ext/ae-doc-code/ae-doc-code.rb +289 -0
  17. data/ext/ae-editor/ae-editor.conf +17 -8
  18. data/ext/ae-editor/ae-editor.rb +738 -396
  19. data/ext/ae-event-log/ae-event-log.conf +0 -0
  20. data/ext/ae-event-log/ae-event-log.rb +0 -0
  21. data/ext/ae-file-history/ae-file-history.conf +2 -2
  22. data/ext/ae-file-history/ae-file-history.rb +286 -290
  23. data/ext/ae-inspector/ae-inspector.conf +0 -0
  24. data/ext/ae-inspector/ae-inspector.rb +0 -0
  25. data/ext/ae-output-event/ae-output-event.conf +2 -2
  26. data/ext/ae-output/ae-output.conf +2 -2
  27. data/ext/ae-output/ae-output.rb +173 -178
  28. data/ext/ae-palette/ae-palette.conf +0 -0
  29. data/ext/ae-palette/ae-palette.rb +0 -0
  30. data/ext/ae-shell/ae-shell.conf +0 -0
  31. data/ext/ae-shell/ae-shell.rb +54 -54
  32. data/lib/tk/al-tk.rb +3076 -3082
  33. data/lib/tk/al-tk.res.rb +0 -0
  34. data/lib/tk/al-tkarcadia.rb +0 -0
  35. data/lib/tk/al-tkcustom.rb +0 -0
  36. data/lib/tkext/al-bwidget.rb +0 -0
  37. data/lib/tkext/al-iwidgets.rb +0 -0
  38. data/lib/tkext/al-tile.rb +0 -0
  39. data/lib/tkext/al-tktable.rb +0 -0
  40. data/tcl/BWidget-1.8.0/BWman/ArrowButton.html +276 -0
  41. data/tcl/BWidget-1.8.0/BWman/BWidget.html +228 -0
  42. data/tcl/BWidget-1.8.0/BWman/Button.html +273 -0
  43. data/tcl/BWidget-1.8.0/BWman/ButtonBox.html +264 -0
  44. data/tcl/BWidget-1.8.0/BWman/ComboBox.html +402 -0
  45. data/tcl/BWidget-1.8.0/BWman/Dialog.html +314 -0
  46. data/tcl/BWidget-1.8.0/BWman/DragSite.html +139 -0
  47. data/tcl/BWidget-1.8.0/BWman/DropSite.html +254 -0
  48. data/tcl/BWidget-1.8.0/BWman/DynamicHelp.html +248 -0
  49. data/tcl/BWidget-1.8.0/BWman/Entry.html +341 -0
  50. data/tcl/BWidget-1.8.0/BWman/Label.html +331 -0
  51. data/tcl/BWidget-1.8.0/BWman/LabelEntry.html +194 -0
  52. data/tcl/BWidget-1.8.0/BWman/LabelFrame.html +144 -0
  53. data/tcl/BWidget-1.8.0/BWman/ListBox.html +678 -0
  54. data/tcl/BWidget-1.8.0/BWman/MainFrame.html +283 -0
  55. data/tcl/BWidget-1.8.0/BWman/MessageDlg.html +218 -0
  56. data/tcl/BWidget-1.8.0/BWman/NoteBook.html +374 -0
  57. data/tcl/BWidget-1.8.0/BWman/PagesManager.html +180 -0
  58. data/tcl/BWidget-1.8.0/BWman/PanedWindow.html +142 -0
  59. data/tcl/BWidget-1.8.0/BWman/PanelFrame.html +153 -0
  60. data/tcl/BWidget-1.8.0/BWman/PasswdDlg.html +214 -0
  61. data/tcl/BWidget-1.8.0/BWman/ProgressBar.html +152 -0
  62. data/tcl/BWidget-1.8.0/BWman/ProgressDlg.html +145 -0
  63. data/tcl/BWidget-1.8.0/BWman/ScrollView.html +130 -0
  64. data/tcl/BWidget-1.8.0/BWman/ScrollableFrame.html +191 -0
  65. data/tcl/BWidget-1.8.0/BWman/ScrolledWindow.html +116 -0
  66. data/tcl/BWidget-1.8.0/BWman/SelectColor.html +164 -0
  67. data/tcl/BWidget-1.8.0/BWman/SelectFont.html +152 -0
  68. data/tcl/BWidget-1.8.0/BWman/Separator.html +77 -0
  69. data/tcl/BWidget-1.8.0/BWman/SpinBox.html +250 -0
  70. data/tcl/BWidget-1.8.0/BWman/StatusBar.html +147 -0
  71. data/tcl/BWidget-1.8.0/BWman/TitleFrame.html +107 -0
  72. data/tcl/BWidget-1.8.0/BWman/Tree.html +947 -0
  73. data/tcl/BWidget-1.8.0/BWman/Widget.html +502 -0
  74. data/tcl/BWidget-1.8.0/BWman/contents.html +84 -0
  75. data/tcl/BWidget-1.8.0/BWman/index.html +7 -0
  76. data/tcl/BWidget-1.8.0/BWman/navtree.html +41 -0
  77. data/tcl/BWidget-1.8.0/BWman/options.htm +458 -0
  78. data/tcl/BWidget-1.8.0/CHANGES.txt +266 -0
  79. data/tcl/BWidget-1.8.0/ChangeLog +1641 -0
  80. data/tcl/BWidget-1.8.0/LICENSE.txt +41 -0
  81. data/tcl/BWidget-1.8.0/README.txt +127 -0
  82. data/tcl/BWidget-1.8.0/arrow.tcl +551 -0
  83. data/tcl/BWidget-1.8.0/bitmap.tcl +94 -0
  84. data/tcl/BWidget-1.8.0/button.tcl +324 -0
  85. data/tcl/BWidget-1.8.0/buttonbox.tcl +403 -0
  86. data/tcl/BWidget-1.8.0/color.tcl +493 -0
  87. data/tcl/BWidget-1.8.0/combobox.tcl +809 -0
  88. data/tcl/BWidget-1.8.0/demo/basic.tcl +199 -0
  89. data/tcl/BWidget-1.8.0/demo/bwidget.xbm +46 -0
  90. data/tcl/BWidget-1.8.0/demo/demo.tcl +212 -0
  91. data/tcl/BWidget-1.8.0/demo/dnd.tcl +42 -0
  92. data/tcl/BWidget-1.8.0/demo/manager.tcl +141 -0
  93. data/tcl/BWidget-1.8.0/demo/select.tcl +59 -0
  94. data/tcl/BWidget-1.8.0/demo/tmpldlg.tcl +214 -0
  95. data/tcl/BWidget-1.8.0/demo/tree.tcl +260 -0
  96. data/tcl/BWidget-1.8.0/demo/x1.xbm +2258 -0
  97. data/tcl/BWidget-1.8.0/dialog.tcl +345 -0
  98. data/tcl/BWidget-1.8.0/dragsite.tcl +197 -0
  99. data/tcl/BWidget-1.8.0/dropsite.tcl +455 -0
  100. data/tcl/BWidget-1.8.0/dynhelp.tcl +625 -0
  101. data/tcl/BWidget-1.8.0/entry.tcl +469 -0
  102. data/tcl/BWidget-1.8.0/font.tcl +566 -0
  103. data/tcl/BWidget-1.8.0/images/bold.gif +0 -0
  104. data/tcl/BWidget-1.8.0/images/copy.gif +0 -0
  105. data/tcl/BWidget-1.8.0/images/cut.gif +0 -0
  106. data/tcl/BWidget-1.8.0/images/dragfile.gif +0 -0
  107. data/tcl/BWidget-1.8.0/images/dragicon.gif +0 -0
  108. data/tcl/BWidget-1.8.0/images/error.gif +0 -0
  109. data/tcl/BWidget-1.8.0/images/file.gif +0 -0
  110. data/tcl/BWidget-1.8.0/images/folder.gif +0 -0
  111. data/tcl/BWidget-1.8.0/images/hourglass.gif +0 -0
  112. data/tcl/BWidget-1.8.0/images/info.gif +0 -0
  113. data/tcl/BWidget-1.8.0/images/italic.gif +0 -0
  114. data/tcl/BWidget-1.8.0/images/minus.xbm +5 -0
  115. data/tcl/BWidget-1.8.0/images/new.gif +0 -0
  116. data/tcl/BWidget-1.8.0/images/opcopy.xbm +5 -0
  117. data/tcl/BWidget-1.8.0/images/open.gif +0 -0
  118. data/tcl/BWidget-1.8.0/images/openfold.gif +0 -0
  119. data/tcl/BWidget-1.8.0/images/oplink.xbm +5 -0
  120. data/tcl/BWidget-1.8.0/images/opmove.xbm +5 -0
  121. data/tcl/BWidget-1.8.0/images/overstrike.gif +0 -0
  122. data/tcl/BWidget-1.8.0/images/palette.gif +0 -0
  123. data/tcl/BWidget-1.8.0/images/passwd.gif +0 -0
  124. data/tcl/BWidget-1.8.0/images/paste.gif +0 -0
  125. data/tcl/BWidget-1.8.0/images/plus.xbm +5 -0
  126. data/tcl/BWidget-1.8.0/images/print.gif +0 -0
  127. data/tcl/BWidget-1.8.0/images/question.gif +0 -0
  128. data/tcl/BWidget-1.8.0/images/redo.gif +0 -0
  129. data/tcl/BWidget-1.8.0/images/save.gif +0 -0
  130. data/tcl/BWidget-1.8.0/images/target.xbm +9 -0
  131. data/tcl/BWidget-1.8.0/images/underline.gif +0 -0
  132. data/tcl/BWidget-1.8.0/images/undo.gif +0 -0
  133. data/tcl/BWidget-1.8.0/images/warning.gif +0 -0
  134. data/tcl/BWidget-1.8.0/init.tcl +40 -0
  135. data/tcl/BWidget-1.8.0/label.tcl +271 -0
  136. data/tcl/BWidget-1.8.0/labelentry.tcl +100 -0
  137. data/tcl/BWidget-1.8.0/labelframe.tcl +160 -0
  138. data/tcl/BWidget-1.8.0/lang/da.rc +52 -0
  139. data/tcl/BWidget-1.8.0/lang/de.rc +52 -0
  140. data/tcl/BWidget-1.8.0/lang/en.rc +52 -0
  141. data/tcl/BWidget-1.8.0/lang/es.rc +53 -0
  142. data/tcl/BWidget-1.8.0/lang/fr.rc +52 -0
  143. data/tcl/BWidget-1.8.0/listbox.tcl +1638 -0
  144. data/tcl/BWidget-1.8.0/mainframe.tcl +711 -0
  145. data/tcl/BWidget-1.8.0/messagedlg.tcl +128 -0
  146. data/tcl/BWidget-1.8.0/notebook.tcl +1164 -0
  147. data/tcl/BWidget-1.8.0/pagesmgr.tcl +294 -0
  148. data/tcl/BWidget-1.8.0/panedw.tcl +381 -0
  149. data/tcl/BWidget-1.8.0/panelframe.tcl +246 -0
  150. data/tcl/BWidget-1.8.0/passwddlg.tcl +178 -0
  151. data/tcl/BWidget-1.8.0/pkgIndex.tcl +47 -0
  152. data/tcl/BWidget-1.8.0/progressbar.tcl +208 -0
  153. data/tcl/BWidget-1.8.0/progressdlg.tcl +87 -0
  154. data/tcl/BWidget-1.8.0/scrollframe.tcl +226 -0
  155. data/tcl/BWidget-1.8.0/scrollview.tcl +254 -0
  156. data/tcl/BWidget-1.8.0/scrollw.tcl +280 -0
  157. data/tcl/BWidget-1.8.0/separator.tcl +75 -0
  158. data/tcl/BWidget-1.8.0/spinbox.tcl +331 -0
  159. data/tcl/BWidget-1.8.0/statusbar.tcl +422 -0
  160. data/tcl/BWidget-1.8.0/tests/entry.test +173 -0
  161. data/tcl/BWidget-1.8.0/titleframe.tcl +170 -0
  162. data/tcl/BWidget-1.8.0/tree.tcl +2228 -0
  163. data/tcl/BWidget-1.8.0/utils.tcl +645 -0
  164. data/tcl/BWidget-1.8.0/widget.tcl +1576 -0
  165. data/tcl/BWidget-1.8.0/wizard.tcl +1028 -0
  166. data/tcl/BWidget-1.8.0/xpm2image.tcl +115 -0
  167. metadata +141 -5
data/tcl/BWidget-1.8.0/BWman/DragSite.html ADDED
@@ -0,0 +1,139 @@
1
+ <HTML>
2
+ <HEAD><TITLE>DragSite</TITLE></HEAD>
3
+ <BODY BGCOLOR=white>
4
+ <DL><DT><I><A HREF="#descr">NAME</A></I></DT>
5
+ <DD><B>DragSite</B>
6
+ - Commands set for Drag facilities
7
+ </DD></DL>
8
+ <DL>
9
+ <DT><I><A HREF="#wc">COMMAND</A></I></DT>
10
+ <DD>DragSite::<A HREF="#include"><B>include</B></A>
11
+ <I>class</I>
12
+ <I>type</I>
13
+ <I>event</I>
14
+ </DD>
15
+ <DD>DragSite::<A HREF="#register"><B>register</B></A>
16
+ <I>path</I>
17
+ ?<I>option value...</I>?
18
+ </DD>
19
+ <DD>DragSite::<A HREF="#setdrag"><B>setdrag</B></A>
20
+ <I>path</I>
21
+ <I>subpath</I>
22
+ <I>initcmd</I>
23
+ <I>endcmd</I>
24
+ ?<I>force</I>?
25
+ </DD>
26
+ </DL>
27
+ <BR><HR WIDTH="100%"><BR>
28
+ <B><A NAME="descr"></A>DESCRIPTION</B><BR>
29
+ <P>
30
+
31
+ Commands of this namespace enable user to define a BWidget or a Tk widget as a drag site.
32
+
33
+
34
+
35
+ </P>
36
+ <HR WIDTH="50%"><BR>
37
+ <B><A NAME="wc">COMMAND</A></B><BR>
38
+ <DL><DT><A NAME="include">DragSite::<B>include</B></A>
39
+ <I>class</I>
40
+ <I>type</I>
41
+ <I>event</I>
42
+ </DT><DD>
43
+
44
+ This command provides a simple way to include options relatives to a drag site into
45
+ BWidget resources definition.
46
+ It includes the options needed for <B>register</B>: <I>-dragevent</I>, initialized to
47
+ <I>event</I>, <I>-draginitcmd</I> and <I>-dragendcmd</I>, initialized to empty string,
48
+ and two new options:
49
+ <TABLE BORDER=0 CELLSPACING=1>
50
+ <TR><TD><I>-dragenabled</I><TD>Specifies wether or not drag is active (initialized to 0)
51
+ <TR><TD><I>-dragtype</I><TD>Default or alternate dragged data type (initialized to <I>type</I>)
52
+ </TABLE>
53
+
54
+ </DD></DL>
55
+ <DL><DT><A NAME="register">DragSite::<B>register</B></A>
56
+ <I>path</I>
57
+ ?<I>option value...</I>?
58
+ </DT><DD>
59
+
60
+ This command is used to declare <I>path</I> as a drag site. Options are:
61
+
62
+ <P>
63
+ <DL><DT><A NAME="DragSite-dragendcmd"><B>-dragendcmd</B></A></DT>
64
+ <DD>
65
+
66
+ Command called when drag terminates (ie when user release drag icon).
67
+ This command is called with the following arguments:
68
+ <UL>
69
+ <LI>the pathname of the drag source (the widget itself),
70
+ <LI>the pathname of the drop target,
71
+ <LI>the operation,
72
+ <LI>the type of the dragged data,
73
+ <LI>the dragged data,
74
+ <LI>result of the drop (result of the call to <B>-dropcmd</B> of the target),
75
+ </UL>
76
+ If the drop does not occurs, the target and the operation are empty string and the result
77
+ is 0.
78
+
79
+ </DD>
80
+ </DL>
81
+ <DL><DT><A NAME="DragSite-dragevent"><B>-dragevent</B></A></DT>
82
+ <DD>
83
+
84
+ Specifies the number of the mouse button associated to the drag.
85
+ Must be <B>1</B>, <B>2</B> or <B>3</B>.
86
+
87
+ </DD>
88
+ </DL>
89
+ <DL><DT><A NAME="DragSite-draginitcmd"><B>-draginitcmd</B></A></DT>
90
+ <DD>
91
+
92
+ Command called when drag initiates. When the event of option <B>dragevent</B> occurs on
93
+ <I>path</I>, this command is called with the following arguments:
94
+ <UL>
95
+ <LI>pathname of the drag source (<I>path</I>),
96
+ <LI>root x-coordinate of pointer,
97
+ <LI>root y-coordinate of pointer,
98
+ <LI>a toplevel created to represent dragged data. When returning, if it
99
+ has no children, a bitmap is automatically displayed.
100
+ </UL>
101
+ The command must return a list containing three elements:
102
+ <UL>
103
+ <LI>the type of the data,
104
+ <LI>the list of acceptable basic operations (<B>copy</B>, <B>move</B> and <B>link</B>)
105
+ <LI>and the data.
106
+ </UL>
107
+ Note that even if <B>copy</B> does not appear in the list of basic operation,
108
+ it is considered as an acceptable operation, since <B>copy</B> semantic does not modify
109
+ the drag source.
110
+
111
+ </DD>
112
+ </DL>
113
+ </DD></DL>
114
+ <DL><DT><A NAME="setdrag">DragSite::<B>setdrag</B></A>
115
+ <I>path</I>
116
+ <I>subpath</I>
117
+ <I>initcmd</I>
118
+ <I>endcmd</I>
119
+ ?<I>force</I>?
120
+ </DT><DD>
121
+
122
+ This command provides a simple way to call <B>register</B> during a BWidget creation or
123
+ configuration.
124
+ <UL>
125
+ <LI><I>path</I> is the pathname of the BWidget,
126
+ <LI><I>subpath</I> is the pathname of the tk widget where drag event occurs,
127
+ <LI><I>initcmd</I> BWidget command for <I>drag-init</I> event,
128
+ <LI><I>endcmd</I> BWidget command for <I>drag-end</I> event,
129
+ <LI><I>force</I> specifies wether or not to call <B>register</B> whenever no option value has
130
+ changed (0 by default - for BWidget configuration, use 1 for BWidget creation).
131
+ </UL>
132
+ <B>setdrag</B> verifies the modification flag of options <B>dragenabled</B> and
133
+ <B>dragevent</B> and calls <B>register</B> if needed according to the options values and
134
+ <I>initcmd</I> and <I>endcmd</I> arguments. <B>draginitcmd</B> and <B>dragendcmd</B> are not
135
+ taken from options of widget because they are considered as user command, called by
136
+ BWidget implementation of <I>drag-init</I> and <I>drag-end</I> events.
137
+
138
+ </DD></DL>
139
+ </BODY></HTML>
data/tcl/BWidget-1.8.0/BWman/DropSite.html ADDED
@@ -0,0 +1,254 @@
1
+ <HTML>
2
+ <HEAD><TITLE>DropSite</TITLE></HEAD>
3
+ <BODY BGCOLOR=white>
4
+ <DL><DT><I><A HREF="#descr">NAME</A></I></DT>
5
+ <DD><B>DropSite</B>
6
+ - Commands set for Drop facilities
7
+ </DD></DL>
8
+ <DL>
9
+ <DT><I><A HREF="#wc">COMMAND</A></I></DT>
10
+ <DD>DropSite::<A HREF="#include"><B>include</B></A>
11
+ <I>class</I>
12
+ <I>types</I>
13
+ </DD>
14
+ <DD>DropSite::<A HREF="#register"><B>register</B></A>
15
+ <I>path</I>
16
+ ?<I>option value...</I>?
17
+ </DD>
18
+ <DD>DropSite::<A HREF="#setcursor"><B>setcursor</B></A>
19
+ <I>cursor</I>
20
+ </DD>
21
+ <DD>DropSite::<A HREF="#setdrop"><B>setdrop</B></A>
22
+ <I>path</I>
23
+ <I>subpath</I>
24
+ <I>dropover</I>
25
+ <I>drop</I>
26
+ ?<I>force</I>?
27
+ </DD>
28
+ <DD>DropSite::<A HREF="#setoperation"><B>setoperation</B></A>
29
+ <I>op</I>
30
+ </DD>
31
+ </DL>
32
+ <BR><HR WIDTH="100%"><BR>
33
+ <B><A NAME="descr"></A>DESCRIPTION</B><BR>
34
+ <P>
35
+
36
+ Commands of this namespace enable user to define a BWidget or a Tk widget as a drop site.
37
+ A drop site is composed of the type of object that can be dropped and associated operation,
38
+ a command called when drop occurs, and a command when an object is dragged over the widget.
39
+ A drop site must have at least one type of acceptable object and a drop command.
40
+
41
+ </P>
42
+ <HR WIDTH="50%"><BR>
43
+ <B><A NAME="wc">COMMAND</A></B><BR>
44
+ <DL><DT><A NAME="include">DropSite::<B>include</B></A>
45
+ <I>class</I>
46
+ <I>types</I>
47
+ </DT><DD>
48
+
49
+ This command provides a simple way to include options relatives to a drop site into
50
+ BWidget resources definition.
51
+ It includes the options needed for <B>register</B>, <I>-dropovercmd</I> and <I>-dropcmd</I>,
52
+ initialized to empty string, and <I>-droptypes</I>, initialized to <I>types</I>,
53
+ and one new option:
54
+ <TABLE BORDER=0 CELLSPACING=1>
55
+ <TR><TD><I>-dropenabled</I><TD>Specifies wether or not drop is active (initialized to 0)
56
+ </TABLE>
57
+
58
+ </DD></DL>
59
+ <DL><DT><A NAME="register">DropSite::<B>register</B></A>
60
+ <I>path</I>
61
+ ?<I>option value...</I>?
62
+ </DT><DD>
63
+
64
+ This command is used to declare <I>path</I> as a drop site. Options are:
65
+
66
+ <P>
67
+ <DL><DT><A NAME="DropSite-dropcmd"><B>-dropcmd</B></A></DT>
68
+ <DD>
69
+
70
+ This command is called when user release the drag icon over a valid drop target widget.
71
+ It takes the same arguments as <B>-dragovercmd</B> command. Its return values is passed
72
+ as a result to the <B>-dragendcmd</B> command of the drag source widget.
73
+
74
+ </DD>
75
+ </DL>
76
+ <DL><DT><A NAME="DropSite-dropovercmd"><B>-dropovercmd</B></A></DT>
77
+ <DD>
78
+
79
+ This command can be used to provide a dynamic drag while <I>drag-over</I> events.
80
+ While a drag occurs, events &lt;Enter&gt;, &lt;Motion&gt; and &lt;Leave&gt; are catched.
81
+ Arguments passed to the command are:
82
+ <UL>
83
+ <LI>pathname of the drop target (the widget itself),
84
+ <LI>pathname of the drag source,
85
+ <LI>event over the drop target: <I>enter</I>, <I>motion</I> or <I>leave</I>,
86
+ <LI>root x-coordinate of the pointer,
87
+ <LI>root y-coordinate of the pointer,
88
+ <LI>operation,
89
+ <LI>type of the dragged data,
90
+ <LI>dragged data.
91
+ </UL>
92
+ Command must the new status of the drag:
93
+ <UL>
94
+ <LI>0 if widget refuse this drag. Command will not be recalled on motion/leave event.
95
+ <LI>1 if widget accept this drag. Command will not be recalled on motion/leave event.
96
+ <LI>2 if widget refuse this drag. Command will be recalled on each motion event to reevaluate.
97
+ <LI>3 if widget accept this drag. Command will be recalled on each motion event to reevaluate.
98
+
99
+ </UL>
100
+ Here is a list of events and associated actions on a DropSite widget. This example
101
+ assumes that dragged data type is valid for the drop target.
102
+ <B>status</B> is the status of the drag on a DropSite. Its value is:
103
+ <BR><BR>
104
+
105
+ <TABLE BORDER CELLSPACING=1 CELLPADDING=4>
106
+ <TR>
107
+ <TD WIDTH="18%" VALIGN="TOP" ALIGN="CENTER">Event</TD>
108
+ <TD WIDTH="10%" VALIGN="TOP" ALIGN="CENTER">Old status</TD>
109
+ <TD WIDTH="48%" VALIGN="TOP" ALIGN="CENTER">Action</TD>
110
+ <TD WIDTH="24%" VALIGN="TOP" ALIGN="CENTER">New status</TD>
111
+ </TR>
112
+ <TR><TD WIDTH="18%" VALIGN="TOP" ROWSPAN=2>
113
+ <FONT SIZE=2>&lt;Enter&gt;</FONT></TD>
114
+ <TD WIDTH="10%" VALIGN="TOP" ROWSPAN=2>
115
+ <FONT SIZE=2>-</FONT></TD>
116
+ <TD WIDTH="48%" VALIGN="TOP">
117
+ <FONT SIZE=2>if DropSite has <B>dropovercmd</B>, call it with <I>enter</I></FONT></TD>
118
+ <TD WIDTH="24%" VALIGN="TOP">
119
+ <FONT SIZE=2>result of <B>dropovercmd</B></FONT></TD>
120
+ </TR>
121
+ <TR><TD WIDTH="48%" VALIGN="TOP">
122
+ <FONT SIZE=2>else</FONT></TD>
123
+ <TD WIDTH="24%" VALIGN="TOP">
124
+ <FONT SIZE=2>1</FONT></TD>
125
+ </TR>
126
+ <TR><TD WIDTH="18%" VALIGN="TOP" ROWSPAN=2>
127
+ <FONT SIZE=2>&lt;Motion&gt;</FONT></TD>
128
+ <TD WIDTH="10%" VALIGN="TOP">
129
+ <FONT SIZE=2>0 or 1</FONT></TD>
130
+ <TD WIDTH="48%" VALIGN="TOP">&nbsp;</TD>
131
+ <TD WIDTH="24%" VALIGN="TOP">
132
+ <FONT SIZE=2>unchanged</FONT></TD>
133
+ </TR>
134
+ <TR><TD WIDTH="10%" VALIGN="TOP">
135
+ <FONT SIZE=2>2 or 3</FONT></TD>
136
+ <TD WIDTH="48%" VALIGN="TOP">
137
+ <FONT SIZE=2>call <B>dropovercmd</B> with <I>motion</I></FONT></TD>
138
+ <TD WIDTH="24%" VALIGN="TOP">
139
+ <FONT SIZE=2>result of <B>dropovercmd</B></FONT></TD>
140
+ </TR>
141
+ <TR><TD WIDTH="18%" VALIGN="TOP" ROWSPAN=2>
142
+ <FONT SIZE=2>&lt;Leave&gt;</FONT>&nbsp;</TD>
143
+ <TD WIDTH="10%" VALIGN="TOP">
144
+ <FONT SIZE=2>0 or 1</FONT></TD>
145
+ <TD WIDTH="48%" VALIGN="TOP">&nbsp;</TD>
146
+ <TD WIDTH="24%" VALIGN="TOP">
147
+ <FONT SIZE=2>-</FONT></TD>
148
+ </TR>
149
+ <TR><TD WIDTH="10%" VALIGN="TOP">
150
+ <FONT SIZE=2>2 or 3</FONT></TD>
151
+ <TD WIDTH="48%" VALIGN="TOP">
152
+ <FONT SIZE=2>call <B>dropovercmd</B> with <I>leave</I></FONT></TD>
153
+ <TD WIDTH="24%" VALIGN="TOP">
154
+ <FONT SIZE=2>-</FONT></TD>
155
+ </TR>
156
+ <TR><TD WIDTH="18%" VALIGN="TOP" ROWSPAN=4>
157
+ <FONT SIZE=2>&lt;Drop&gt;</FONT></TD>
158
+ <TD WIDTH="10%" VALIGN="TOP">
159
+ <FONT SIZE=2>0</FONT></TD>
160
+ <TD WIDTH="48%" VALIGN="TOP">
161
+ <FONT SIZE=2>call <B>dragendcmd</B> of drag source</FONT></TD>
162
+ <TD WIDTH="24%" VALIGN="TOP" ROWSPAN=4>
163
+ <FONT SIZE=2>-</FONT></TD>
164
+ </TR>
165
+ <TR><TD WIDTH="10%" VALIGN="TOP">
166
+ <FONT SIZE=2>1</FONT></TD>
167
+ <TD WIDTH="48%" VALIGN="TOP">
168
+ <FONT SIZE=2>call <B>dropcmd</B> and call <B>dragendcmd</B> of drag source</FONT></TD>
169
+ </TR>
170
+ <TR><TD WIDTH="10%" VALIGN="TOP">
171
+ <FONT SIZE=2>2</FONT></TD>
172
+ <TD WIDTH="48%" VALIGN="TOP">
173
+ <FONT SIZE=2>call <B>dropovercmd</B> with <I>leave</I> and call <B>dragendcmd</B> of drag source</FONT></TD>
174
+ </TR>
175
+ <TR><TD WIDTH="10%" VALIGN="TOP">
176
+ <FONT SIZE=2>3</FONT></TD>
177
+ <TD WIDTH="48%" VALIGN="TOP">
178
+ <FONT SIZE=2>call <B>dropcmd</B> and call <B>dragendcmd</B> of drag source</FONT></TD>
179
+ </TR>
180
+ </TABLE>
181
+ <BR>
182
+
183
+ </DD>
184
+ </DL>
185
+ <DL><DT><A NAME="DropSite-droptypes"><B>-droptypes</B></A></DT>
186
+ <DD>
187
+
188
+ Specifies a list {<I>type</I> <I>oplist</I> ?<I>type</I> <I>oplist</I>? ...} of acceptable
189
+ types and associated operations for the drop target.
190
+ For each type, <I>oplist</I> is a list
191
+ {<I>descops</I> <I>mod</I> ?<I>descops</I> <I>mod</I>? ...} describing operations and
192
+ modifier keys for these operations.
193
+ <I>descops</I> describe an operation. It can be a predefined operations (<B>copy</B>,
194
+ <B>move</B> or <B>link</B>) or a new user defined operation, of the form {<I>subop</I>
195
+ <B>baseop</B> ?<I>bitmap</I>?}.
196
+ <I>subop</I> is the name given to the sub operation, <I>baseop</I> is the name of the
197
+ base operation (<B>copy</B>, <B>move</B> or <B>link</B>) and <I>bitmap</I> is a bitmap
198
+ to display for the operation.
199
+ <BR>If <I>bitmap</I> is empty, the default bitmap of the base operation is used for the
200
+ sub operation.
201
+ <BR><I>subop</I> can be a base operation, in order to change the bitmap of a base operation.
202
+ In this case, <I>baseop</I> must be empty or equal to <I>subop</I>.
203
+ <BR><I>mod</I> is the modifer key for the operation. It can be:
204
+ <UL>
205
+ <LI><B>none</B> to specify that no modifier key is pressed. This modifier can only be used
206
+ with a sub operation named <B>default</B> (and vice versa), which has the behaviour of not
207
+ display any bitmap operation. For all type, if the modifier <B>none</B> is not given, it is
208
+ automatically associated to the <B>default</B> sub operation of a <B>copy</B> base operation.
209
+ <LI><B>program</B> to specifies a sub operation accessible only by <B>DropSite::setoperation</B>.
210
+ <LI>A list combining <B>shift</B>, <B>control</B> and <B>alt</B>, which means their
211
+ corresponding key.
212
+ </UL>
213
+
214
+ </DD>
215
+ </DL>
216
+ </DD></DL>
217
+ <DL><DT><A NAME="setcursor">DropSite::<B>setcursor</B></A>
218
+ <I>cursor</I>
219
+ </DT><DD>
220
+
221
+ This command can be used within the script <B>dragovercmd</B>. It is usefull to provide
222
+ visual effect about the state of the drag.
223
+ </DD></DL>
224
+ <DL><DT><A NAME="setdrop">DropSite::<B>setdrop</B></A>
225
+ <I>path</I>
226
+ <I>subpath</I>
227
+ <I>dropover</I>
228
+ <I>drop</I>
229
+ ?<I>force</I>?
230
+ </DT><DD>
231
+
232
+ This command provides a simple way to call <B>register</B> during a BWidget creation or
233
+ configuration.
234
+ <UL>
235
+ <LI><I>path</I> is the pathname of the BWidget,
236
+ <LI><I>subpath</I> is the pathname of the tk widget where drag event occurs,
237
+ <LI><I>dropover</I> is a command for <I>drag-over</I> event,
238
+ <LI><I>drop</I> is a command for <I>drop</I> event,
239
+ <LI><I>force</I> specifies wether or not to call <B>register</B> whenever no option value
240
+ has changed (0 by default - for BWidget configuration, use 1 for BWidget creation).
241
+ </UL>
242
+ <B>setdrop</B> verifies the modification flag of options <B>dropenabled</B> and
243
+ <B>droptypes</B> and calls <B>register</B> if needed according to the options values and
244
+ <I>dropover</I> and <I>drop</I> arguments. <B>dropovercmd</B> and <B>dropcmd</B> are not
245
+ taken from options of widget because they are considered as user command, called by
246
+ BWidget implementation of <I>drag-over</I> and <I>drop</I> events.
247
+
248
+ </DD></DL>
249
+ <DL><DT><A NAME="setoperation">DropSite::<B>setoperation</B></A>
250
+ <I>op</I>
251
+ </DT><DD>
252
+ Description text
253
+ </DD></DL>
254
+ </BODY></HTML>
data/tcl/BWidget-1.8.0/BWman/DynamicHelp.html ADDED
@@ -0,0 +1,248 @@
1
+ <HTML>
2
+ <HEAD><TITLE>DynamicHelp</TITLE></HEAD>
3
+ <BODY BGCOLOR=white>
4
+ <DL><DT><I><A HREF="#descr">NAME</A></I></DT>
5
+ <DD><B>DynamicHelp</B>
6
+ - Provide help to Tk widget or BWidget
7
+ </DD></DL>
8
+ <DL>
9
+ <DT><I><A HREF="#wc">COMMAND</A></I></DT>
10
+ <DD>DynamicHelp::<A HREF="#add"><B>add</B></A>
11
+ <i>widget</i> ?<I>option value ...</I>?
12
+ </DD>
13
+ <DD>DynamicHelp::<A HREF="#configure"><B>configure</B></A>
14
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
15
+ </DD>
16
+ <DD>DynamicHelp::<A HREF="#delete"><B>delete</B></A>
17
+ <i>widget</i>
18
+ </DD>
19
+ <DD>DynamicHelp::<A HREF="#include"><B>include</B></A>
20
+ <I>class</I>
21
+ <I>type</I>
22
+ </DD>
23
+ <DD>DynamicHelp::<A HREF="#register"><B>register</B></A>
24
+ <I>path</I>
25
+ <I>type</I>
26
+ ?<I>arg...</I>?
27
+ </DD>
28
+ <DD>DynamicHelp::<A HREF="#sethelp"><B>sethelp</B></A>
29
+ <I>path</I>
30
+ <I>subpath</I>
31
+ ?<I>force</I>?
32
+ </DD>
33
+ </DL>
34
+ <BR><HR WIDTH="100%"><BR>
35
+ <B><A NAME="descr"></A>DESCRIPTION</B><BR>
36
+ <P>
37
+ Description text
38
+ </P>
39
+ <HR WIDTH="50%"><BR>
40
+ <B><A NAME="wc">COMMAND</A></B><BR>
41
+
42
+ <DL><DT><A NAME="add">DynamicHelp::<B>add</B></A>
43
+ ?<I>option value ...</I>?
44
+ </DT><DD>
45
+ <p>
46
+ This command adds dynamic help to the given <i>widget</i>.
47
+ </p>
48
+ <DL><DT><A NAME="add-command"><B>-command</B></A></DT>
49
+ <DD>
50
+ If specified, refers to a command to execute to get the help
51
+ text to display. The command must return a string to display.
52
+ If the command returns an empty string, no help is displayed.
53
+ </DD>
54
+ </DL>
55
+
56
+ <DL><DT><A NAME="add-index"><B>-index</B></A></DT>
57
+ <DD>
58
+ If specified, refers to a menu index to bind the help to instead of
59
+ a widget. If <b>-type</b> is not menu, this option is ignored.
60
+ </DD>
61
+ </DL>
62
+
63
+ <DL><DT><A NAME="add-item"><B>-item</B></A></DT>
64
+ <DD>
65
+ If specified, refers to an item or tag on a canvas to bind the
66
+ help to instead of a widget.
67
+ </DD>
68
+ </DL>
69
+
70
+ <DL><DT><A NAME="add-type"><B>-type</B></A></DT>
71
+ <DD>
72
+ Specifies the type of help. Can be:
73
+ <b>balloon</b>, <b>variable</b> or <b>menu</b>.
74
+ Default is <b>balloon</b>.
75
+ </DD>
76
+ </DL>
77
+
78
+ <DL><DT><A NAME="add-text"><B>-text</B></A></DT>
79
+ <DD>
80
+ The text to be displayed as help.
81
+ </DD>
82
+ </DL>
83
+
84
+ <DL><DT><A NAME="add-variable"><B>-variable</B></A></DT>
85
+ <DD>
86
+ Specifies a variable name to which the help string will be
87
+ written. Some other widget (e.g., a status bar) is
88
+ responsible for displaying this variable.
89
+ </DD>
90
+ </DL>
91
+
92
+ <p>
93
+ Creating dynamic help for a menu is a two-step process. The menu
94
+ itself must first be added and then each menu entry must be added
95
+ separately. Here is a brief example.
96
+ </p>
97
+
98
+ <TABLE BORDER=2 CELLSPACING=2 WIDTH="80%">
99
+ <TR><TD><PRE>
100
+ <FONT COLOR=red><I># create menu</I></FONT>
101
+ menu .m -type menubar
102
+ <FONT COLOR=red><I># associate menubar to toplevel BEFORE DynamicHelp::register</I></FONT>
103
+ <FONT COLOR=red><I># to make it works with menu clone name</I></FONT>
104
+ . configure -menu .m
105
+ .m add cascade -label "File" -menu .m.file
106
+ menu .m.file
107
+ .m.file add command -label "Open..."
108
+ .m.file add command -label "Quit"
109
+ <FONT COLOR=red><I># create label for help, using variable varinfo</I></FONT>
110
+ label .l -textvariable varinfo
111
+ <FONT COLOR=red><I># associate all entries of menu .m.file to variable varinfo</I></FONT>
112
+ DynamicHelp::add .m.file -type menu -variable varinfo
113
+ <FONT COLOR=red><I># then declare entries of .m.file</I></FONT>
114
+ DynamicHelp::add .m.file -type menu -index 0 -text "Detach menu"
115
+ DynamicHelp::add .m.file -type menu -index 1 -text "Open a file"
116
+ DynamicHelp::add .m.file -type menu -index 2 -text "Exit demo"
117
+ </PRE></TD></TR></TABLE></CENTER>
118
+
119
+ </DL>
120
+
121
+ <DL><DT><A NAME="configure">DynamicHelp::<B>configure</B></A>
122
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
123
+ </DT><DD>
124
+ This command configure the ballon help.
125
+ <P>
126
+ <DL><DT><A NAME="DynamicHelp-borderwidth"><B>-borderwidth</B></A></DT>
127
+ <DD>
128
+ Width of the black border around the balloon.
129
+ </DD>
130
+ </DL>
131
+ <DL><DT><A NAME="DynamicHelp-delay"><B>-delay</B></A></DT>
132
+ <DD>
133
+ Define the delay in millisecond of mouse inactivity before displaying
134
+ the balloon.
135
+ </DD>
136
+ </DL>
137
+ <dl>
138
+ <dt><a name="DynamicHelp-state"><b>-state</b></a></dt>
139
+ <dd>
140
+ Specifies one of two states for help balloons: <b>normal</b> and
141
+ <b>disabled</b>.
142
+ </dd>
143
+ <dd>
144
+ If <b>state</b> is <b>disabled</b>, help balloons will not be displayed
145
+ for any registered widget.
146
+ </dd>
147
+ </dl>
148
+ <DL><DT><A NAME="DynamicHelp-topbackground"><B>-topbackground</B></A></DT>
149
+ <DD>
150
+ The background color of the toplevel window created for a balloon.
151
+ </DD>
152
+ </DL>
153
+ <BR>Other standard options are:
154
+ <DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
155
+ <TR>
156
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-background">-background or -bg</A></TD>
157
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-font">-font</A></TR>
158
+ </TR>
159
+ <TR>
160
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-foreground">-foreground or -fg</A></TD>
161
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-justify">-justify</A></TR>
162
+ </TR>
163
+ <TR>
164
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-padx">-padx</A></TD>
165
+ <TD>&nbsp;&nbsp;<A HREF="options.htm#M-pady">-pady</A></TR>
166
+ </TR>
167
+ </TABLE></DD>
168
+ </DD></DL>
169
+
170
+ <DL><DT><A NAME="delete">DynamicHelp::<B>delete</B></A>
171
+ <I>widget</I>
172
+ </DT><DD>
173
+ Delete all dynamic help for the given <i>widget</i>.
174
+ </DD></DL>
175
+
176
+ <DL><DT><A NAME="include">DynamicHelp::<B>include</B></A>
177
+ <I>class</I>
178
+ <I>type</I>
179
+ </DT><DD>
180
+ Description text
181
+ </DD></DL>
182
+ <DL><DT><A NAME="register">DynamicHelp::<B>register</B></A>
183
+ <I>path</I>
184
+ <I>type</I>
185
+ ?<I>arg...</I>?
186
+ </DT><DD>
187
+ <p>
188
+ <b>Its use is deprecated. Use <i>DynamicHelp::add</i> instead.</b>
189
+ </p>
190
+
191
+ Register a help text to the widget <I>path</I>.
192
+ <I>type</I> determines the type of the help or the type of the widget.
193
+ Depending on <I>type</I>, other options must be provided.
194
+ <BR>
195
+ <TABLE CELLSPACING=5 CELLPADDING=0 BORDER=0>
196
+ <TR><TD><B> type </B></TD><TD><B> options </B></TD></TR>
197
+ <TR><TD><B><I> balloon </I></B></TD><TD><I> ?tagOrItem? text </I></TD></TR>
198
+ <TR><TD><B><I> variable </I></B></TD><TD><I> ?tagOrItem? varName text </I></TD></TR>
199
+ <TR><TD><B><I> menu </I></B></TD><TD><I> varName </I></TD></TR>
200
+ <TR><TD><B><I> menuentry </I></B></TD><TD><I> index text </I></TD></TR>
201
+ </TABLE>
202
+ <BR>If one of the option is missing or is empty, help is removed for this widget.
203
+ <p>
204
+ If <i>tagOrItem</i> is specified, then <i>path</i> is a canvas, and
205
+ <i>tagOrItem</i> is the name of a tag or item on the canvas to which
206
+ the help will be bound.
207
+ </p>
208
+ For type other than <I>balloon</I>, <I>varName</I> is typically a variable
209
+ linked to a label.
210
+ <BR>For menu, balloon type help is not available. To declare a help for menu,
211
+ you first declare the menu, and then entries of this menu.
212
+ <BR>For example:
213
+ <BR><BR>
214
+ <CENTER>
215
+ <TABLE BORDER=2 CELLSPACING=2 WIDTH="80%">
216
+ <TR><TD><PRE>
217
+ <FONT COLOR=red><I># create menu</I></FONT>
218
+ menu .m -type menubar
219
+ <FONT COLOR=red><I># associate menubar to toplevel BEFORE DynamicHelp::register</I></FONT>
220
+ <FONT COLOR=red><I># to make it works with menu clone name</I></FONT>
221
+ . configure -menu .m
222
+ .m add cascade -label "File" -menu .m.file
223
+ menu .m.file
224
+ .m.file add command -label "Open..."
225
+ .m.file add command -label "Quit"
226
+ <FONT COLOR=red><I># create label for help, using variable varinfo</I></FONT>
227
+ label .l -textvariable varinfo
228
+ <FONT COLOR=red><I># associate all entries of menu .m.file to variable varinfo</I></FONT>
229
+ DynamicHelp::register .m.file menu varinfo
230
+ <FONT COLOR=red><I># then declare entries of .m.file</I></FONT>
231
+ DynamicHelp::register .m.file menuentry 0 "Detach menu"
232
+ DynamicHelp::register .m.file menuentry 1 "Open a file"
233
+ DynamicHelp::register .m.file menuentry 2 "Exit demo"
234
+ </PRE></TD></TR></TABLE></CENTER>
235
+ <BR>
236
+ <BR>Notice that if popup menu is owned by a menubar, you must associate first the menubar
237
+ to its toplevel. In this case, when you create a menu popup, its clone window is also
238
+ created, and DynamicHelp::register detects the exitence of the clone window and maps
239
+ events to it.
240
+ </DD></DL>
241
+ <DL><DT><A NAME="sethelp">DynamicHelp::<B>sethelp</B></A>
242
+ <I>path</I>
243
+ <I>subpath</I>
244
+ ?<I>force</I>?
245
+ </DT><DD>
246
+ Description text
247
+ </DD></DL>
248
+ </BODY></HTML>