home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / dc-ny081.lha / Classes_Jun-18-96.lha / ClassUpdate / history.doc < prev    next >
Encoding:
Text File  |  1996-06-17  |  11.5 KB  |  377 lines
  1. This file hilites some of the most notable changes to the ClassAct
  2. classes for release 2.0 and includes sections of the related autodoc
  3. for new class tags. This is an accumlative listing.
  4.  
  5. *************************************************************************
  6.  
  7. CLASS: bevel.image 41.16
  8.  
  9. BUGS/CHANGES:
  10.  
  11. Now implements nearly all beveling preference options, including bevel
  12. style, default group label positioning, 3D group label shadow, etc.
  13.  
  14. Fixed intermediate release bug causing omission of disable pattern
  15. rendering for draw states of IDS_DISABLED and IDS_SELECTDISABLED.
  16.  
  17. Fixed enforcer hits caused by rendering the new XEN bevels with out DrawInfo.
  18.  
  19. NEW TAGS:
  20.  
  21.         BEVEL_ColorMap (struct ColorMap *) 
  22.             Screen ViewPort ColorMap, this tag is required tag for
  23.             proper BVS_BUTTON xen shadow pen selections.
  24.  
  25.             Defaults to NULL.
  26.  
  27.             Applicability is (OM_NEW, OM_SET)
  28.  
  29.         BEVEL_Flags
  30.             Intentionally left undocumented! Used for some hidden
  31.             BVS_BUTTON xen style magic. Class authors inquire as needed.
  32.  
  33.             Defaults to 0.
  34.  
  35.             Applicability is (OM_NEW, OM_SET)
  36.  
  37.  
  38. *************************************************************************
  39.  
  40. CLASS: integer.gadget 41.127
  41.  
  42. BUGS/CHANGES:
  43.  
  44. Implemented INTEGER_MinVisible tag, see below.
  45.  
  46. NEW TAGS:
  47.  
  48.         INTEGER_MinVisible (WORD)
  49.             Set the minimum number of characters that should be
  50.             visible for a 'GDOMAIN_MIMIMUM' domain size. This is a handy
  51.             addition present in V41.127 or later to ensure a mimimum
  52.             number characters will be visible in a integer gadget.
  53.  
  54. *************************************************************************
  55.  
  56. CLASS: palette.gadget 40.222
  57.  
  58. BUGS/CHANGES:
  59.  
  60. Now correctly renders itself with all beveling preference modes.
  61.  
  62. NEW TAGS: none
  63.  
  64. *************************************************************************
  65.  
  66. CLASS: listbrowser.gadget 41.192
  67.  
  68. BUGS/CHANGES:
  69.  
  70. Added additional methods for optimized adding and refresh of
  71. specific nodes in a list.
  72.  
  73. Now correctly renders itself with beveling preference modes.
  74.  
  75. Handles lists with total node pixel count greater than 32768 pixels.
  76. propgclass on which scroller.gadget prior to V42 beta can only handle
  77. WORD variables. Because listbrowser smooth pixel scrolls, there was
  78. a good potential to overrun the WORD ranges. Scaled values are now
  79. used on large lists, in addition the new V42 beta scroller class
  80. handles LONG values and is implemented independant of propgclass.
  81.  
  82. Implmented additional mode of operation, see new tags below.
  83.  
  84. Tweaked Scroller size on 640x200 screens.
  85.  
  86. Now handles empty lists w/o enforcer hit(s).
  87.  
  88.  
  89. NEW TAGS: 
  90.  
  91.         LISTBROWSER_HorizSeparators    (BOOL) (V41)
  92.             Renders horizontal lines below each node.  This is useful if your
  93.             listbrowser is very wide, and you want to make it easier for
  94.             users to follow the rows of data.
  95.  
  96.             Defaults to FALSE.
  97.  
  98.             Applicability is (OM_NEW, OM_GET, OM_SET)
  99.  
  100.         LISTBROWSER_CheckImage (struct Image *) (V41)
  101.             Provide a custom image for a checkbox node while that node is
  102.             in the checked state.  A NULL image means that listbrowser
  103.             render some default imagery.
  104.  
  105.             Defaults to NULL.
  106.  
  107.             Applicability is (OM_NEW, OM_GET, OM_SET)
  108.  
  109.         LISTBROWSER_UncheckedImage (struct Image *) (V41)
  110.             Provide a custom image for a checkbox node while that node is
  111.             in the unchecked state.  A NULL image means that listbrowser
  112.             render some default imagery.
  113.  
  114.             Defaults to NULL.
  115.  
  116.             Applicability is (OM_NEW, OM_GET, OM_SET)
  117.  
  118.         LISTBROWSER_TotalNodes (LONG) (V41)
  119.             Return the total number of nodes currently attached to the
  120.             listbrowser.
  121.  
  122.             Applicability is (OM_GET)
  123.  
  124. *************************************************************************
  125.  
  126. CLASS: button.gadget 40.88
  127.  
  128. BUGS/CHANGES:
  129.  
  130. Nominal domain now sizes 2 pixel taller, and 6 pixels + bevel size wider.
  131.  
  132. Tweaked minimum domain height to me 2 pixels taller.
  133.  
  134. Fixed autobuttons domain height to fontheight + 7 to match
  135. string, and titleless dropdown chooser regardless of bevel types.
  136.  
  137. NEW TAGS:
  138.  
  139.         BUTTON_DomainString (STRPTR)
  140.             Used to specify the NULL terminated string to use as the text
  141.             to domain the gadgets minimum size. This string is NEVER
  142.             rendered on screen. This is useful when you need to create
  143.             a button with a empty ("") or NULL string, but want to enforce
  144.             minimum size in a layout group based on some initializing
  145.             string and the current preferenced font.
  146.  
  147.             Defaults to NULL.
  148.  
  149.             Applicability is (OM_NEW, OM_SET)
  150.  
  151. *************************************************************************
  152.  
  153. CLASS: chooser.gadget 40.87
  154.  
  155. BUGS/CHANGES:
  156.  
  157. Now StackSwap()'s input methods when under input.device task context so
  158. to avoid a potential stack overrun on certain systems when opening the
  159. popup/dropdown selection window. This overrun was especially apparent
  160. on EGS systems.
  161.  
  162. Fixed titleless dropdown domain height to fontheight + 7 to match
  163. string, and autobuttons regardless of bevel types.
  164.  
  165. NEW TAGS:
  166.  
  167. New option(s) for AllocChooserNodeAttrsA() and SetChooserNodeAttrsA();
  168.  
  169.         CNA_SelImage (struct Image *)
  170.  
  171.         Selected state Image to be placed to the left of the CNA_Text in
  172.         the Chooser menu. Background image pen remapping is not currently
  173.         implemented.
  174.  
  175.  
  176. *************************************************************************
  177.  
  178. CLASS: clicktab.gadget 40.21
  179.  
  180. BUGS/CHANGES:
  181.  
  182. New render styling, thought to to be more visually pleasing by most :)
  183.  
  184. Minimized rendering and return of GADGETUP when selecting the
  185. page that is already current.
  186.  
  187. TNA_Enabled changed to TNA_Disabled for consistancy with other tags
  188. but is still not supported anyway, so no harm done!
  189.  
  190. Reduced click tab height for better look on 640x200 screens, and
  191. reduced popup action from 2 pixels to 1 pixel. All in all, I'd
  192. say its an improvement.
  193.  
  194. NEW TAGS:
  195.  
  196. New option(s) for AllocClickTabNodeAttrsA() and SetClickTabNodeAttrsA();
  197.  
  198.     TNA_TextPen (WORD)
  199.  
  200.     Specifies pen number to use for the label.
  201.     Defaults to pens[TEXTPEN].
  202.  
  203. *************************************************************************
  204.  
  205. CLASS: fuelgauge.gadget 40.32
  206.  
  207. BUGS/CHANGES:
  208.  
  209. Fully fills inner bevel areas for all bevel preference modes.
  210.  
  211. Added additional text rendering support, including VarArgs much like
  212. that which is supported by button.gadget.
  213.  
  214. NEW TAGS:
  215.  
  216.  
  217.         FUELGAUGE_VarArgs (APTR)
  218.             Varargs data array to supply data for RawDoFmt() when
  219.             format specifiers are to be used in GA_Text text strings.
  220.  
  221.             Defaults to NULL.
  222.  
  223.             Applicability is (OM_NEW, OM_SET)
  224.  
  225.         FUELGAUGE_Justification (WORD)
  226.             Justification mode of fuelgauge (GA_Text) text label.
  227.             Percentage rendering, when enabled, is always centered.
  228.  
  229.             Supports:
  230.  
  231.                 FGJ_LEFT
  232.                 FGJ_CENTER
  233.  
  234.             Defaults to FGJ_LEFT.
  235.  
  236.             Applicability is (OM_NEW, OM_SET)
  237.  
  238. *************************************************************************
  239.  
  240. CLASS: layout.gadget 42.18
  241.  
  242. BUGS/CHANGES:
  243.  
  244. Optimized domain, layout and render methods for greater speed.
  245.  
  246. Layout error introduced durring code optimizations introduced a small
  247. layout spacing error between the first two objects, now fixed.
  248.  
  249. Resize no longer cancels GA_ReadOnly setting.
  250.  
  251. 42.16 snuck out on May 30th 96 - dispose would have caused enforcer hits
  252. or a crash on some layout groups (notable in AWeb prefs). It was an
  253. intermediate bug that krept in and promptly fixed in 42.17.
  254.  
  255. NEW TAGS:
  256.  
  257.         CHILD_ScaleHeight (UWORD)
  258.         CHILD_ScaleWidth (UWORD)
  259.             Cause the minimum domain size of an object to be 
  260.             scaled to a larger value. IE, a value of 20 with
  261.             a min domain size of 50 results in a 60 pixel minimum.
  262.  
  263.             That is to say;
  264.  
  265.                 newmin = min + ((scale * min)/100);
  266.  
  267.             These tags are handy for use on listbrowser object to extend
  268.             the width or height to a more realistic size. Because this
  269.             scaling could potentially force a layout beyond the maximum
  270.             size for a screen (thus causing a potential font fallback)
  271.             you should use some commen sence as to when to apply such
  272.             a scalar, and how much is overkill.
  273.  
  274.             Defaults to 0.
  275.  
  276.             Applicability is (OM_NEW, OM_SET)
  277.  
  278. *************************************************************************
  279.  
  280. CLASS: radiobutton.gadget 40.14
  281.  
  282. BUGS/CHANGES:
  283.  
  284. Corrected keyboard control so selection wraps around rather than
  285. incrementing or decrementing selection to an invalid/invisible selection.
  286.  
  287. NEW TAGS:
  288.  
  289. *************************************************************************
  290.  
  291. CLASS: speedbar.gadget 40.56
  292.  
  293. BUGS/CHANGES:
  294.  
  295. Corrected various potential bugs in SBNA_Toggle/SBNA_MXGroup handling.
  296.  
  297. Implemented SPEEDBAR_EvenSize tag.
  298.  
  299. Implemented SBNA_Disabled.
  300.  
  301. Now safty checks for empty lists, but to domain correctly your buttons
  302. must be added to the bar before domain/layout occurs.
  303.  
  304. Fixed, or atleast improved rendering/centering of vertical orientated
  305. bars.
  306.  
  307.  
  308. NEW TAGS:
  309.  
  310.         SPEEDBAR_EvenSize (BOOL)
  311.             Causes all buttons in the bar to size equal to the largest.
  312.  
  313.             Defaults to FALSE.
  314.  
  315.             Applicability is (OM_NEW, OM_SET, OM_GET)
  316.  
  317. New option(s) for AllocSpeedBarNodeAttrsA() and SetSpeedBarNodeAttrsA();
  318.  
  319.     SBNA_Disabled (BOOL)
  320.  
  321.     Set a button in the bar as disabled. If setting this after the bar
  322.     has been rendered, you must follow this with RefreshGList() on the
  323.     speedbar object to cause the disable rendering to occur.
  324.  
  325.     Defaults to FALSE.
  326.  
  327. *************************************************************************
  328.  
  329. CLASS: string.gadget 40.36
  330.  
  331. BUGS/CHANGES:
  332.  
  333. Incorrect semaphore in dispatcher allowed potential deadlock situation.
  334.  
  335. Fixed domain height to fontheight + 7 to match autobuttons and
  336. titleless dropdown choosers regardless of bevel types. And, caused
  337. string gadget height to be more uniform with integer gadget height
  338. which generally makes the GUI display look alot better, especially
  339. for 640x200 users where the prior versions of string gadget where a
  340. bit too tall.
  341.  
  342. NEW TAGS:
  343.  
  344.         STRINGA_MinVisible (WORD)
  345.             Set the minimum number of characters that should be
  346.             visible for a 'GDOMAIN_MIMIMUM' domain size. Nominal
  347.             domain sizes to twice this minimum. This is a handy
  348.             addition present in V40.35 or later to ensure a mimimum
  349.             number characters will be visible in a string gadget.
  350.  
  351. *************************************************************************
  352.  
  353. CLASS: window.class 41.24
  354.  
  355. BUGS/CHANGES:
  356.  
  357. Setting WA_BusyPointer TRUE will turn off defer layout so if the app
  358. is busy, a simple refresh window or resized window will refresh
  359. normally while the application is theoretically busy to process
  360. the window class input which causes the defer refresh to occur.
  361. Setting the busy state FALSE will return defer layout to the previous
  362. setting. In addition, GA_ReadOnly is also set/cleared on the window
  363. layout as well, a busy window will not accept input. If this is
  364. counter productive to you, you may override this by setting GA_ReadOnly
  365. FALSE (on the layout). In addition, a busy window will also call
  366. OffMenu(NOITEM) or OnMenu(NOITEM) to disable the menu bar.
  367.  
  368. It should be noted, checked menu items should be tracked/rechecked,
  369. this change was hoped to avoid that by window class not using
  370. ClearMenuStrip()/ResetMenuStrip() but this does not work fully either.
  371.  
  372. NEW TAGS:
  373.  
  374.         None.
  375.  
  376. *************************************************************************
  377.