home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / documentation / documents / a252icon < prev    next >
Internet Message Format  |  1999-04-27  |  3KB
  1. From: plebeau@cix.compulink.co.uk (Paul Lebeau)
  2. Subject: iconizing, 3d icons
  3. Date: 13 Oct 92 12:39:33 GMT
  4.  
  5.  
  6. Okay, okay, here is the full info on the new validation commands...
  7.  
  8. (The following is a slightly edited form of documentation
  9. supplied to developers by Acorn)
  10.  
  11.  
  12. ------------------------
  13. R<Type>,<Slab in colour>
  14. ------------------------
  15.  
  16.      Where <Type> is:
  17.  
  18.         0 => normal single pixel border
  19.         1 => slab out
  20.         2 => slab in
  21.         3 => ridge
  22.         4 => channel
  23.         5 => action button (highlights when icon selected)
  24.         6 => default action button (highlights when icon selected)
  25.         7 => editable field
  26.  
  27.      >= 8 => normal single pixel border
  28.  
  29. The second number relates to the highlight colour applied on
  30. border types 5,6.  By default this is 14 but the validation string
  31. can over-ride this, when the icon is selected the foreground
  32. colour is retained and the background changes to the highlight
  33. colour.
  34.  
  35. The borders are plotted on the inside of the icon border and only
  36. if the border bit is set as well.
  37.  
  38.  
  39. -------------------------------
  40. P<spritename>,active_x,active_y
  41. -------------------------------
  42. To change the pointer shape while over the icon.
  43.  
  44.  
  45. -----------------------------------
  46. K followed by any or all of R,A,T,D
  47. -----------------------------------
  48.  
  49. IF KR is present in the icon's validation string and the icon is
  50. not the last icon in the window, pressing <Return> in the icon
  51. will move the caret to the beginning of the next writable icon in
  52. the window. If the icon is the last writable icon in the window
  53. the <Return> (Code 13) will be passed to the application as in
  54. WIMP 2.00.
  55.  
  56. IF KA is present in the icon's validation string, pressing the up
  57. or down arrow keys will move the caret to the previous or next
  58. writable icon in the window, retaining the same position in the
  59. string. Pressing up in the first writable icon in a window will
  60. move the caret to the last writable icon, and pressing down in the
  61. last icon will move the caret to the first icon.
  62.  
  63. IF KT is present in the icon's validation string, pressing TAB in
  64. the icon will move the caret to the beginning of the next writable
  65. icon in the window. Pressing Shift+TAB will move the caret to the
  66. beginning of the previous writable icon in the window, the caret
  67. wraps around from last to first and first to last as per arrow
  68. keys with KA.
  69.  
  70. IF KD is present in the icon's validation string, pressing any of
  71. <Copy>,<Delete>,<Shift>+<Copy>,<Ctrl>+U,<Ctrl>+Copy will notify
  72. the application with the appropriate key code as well as doing its
  73. defined action as defined in the RISC OS 2.00 PRM.
  74.  
  75. IF KN is present in the icon's validation string, the application
  76. will be notified about all key presses in the icon, even if they
  77. are handled by the WIMP.
  78.  
  79. Options can be combined by including more than one option letter
  80. after the K command (e.g. KAR will give the arrow and return
  81. functionality).
  82.  
  83. ---
  84.  
  85. Ka kite ano
  86.  
  87. ------------------------------------------------------------------
  88. Paul LeBeau
  89. 4Mation
  90. plebeau@cix.compulink.co.uk
  91.