[Contents] [Index] [Help] [Browse <] [Browse >]

 -- Command: object ID/K, HELP/K, NODE/K, CLASS/K, BOOPSI/S, ATTRS/K/M
     Objects from MUI internal, external and BOOPSI classes are created
     with this command.  Note that while this is a very powerful and
     flexible command it can easily result in the unexpected, including
     system crashes, so beware.

        * ID [I..] - an id can be assigned to a object for later
          reference. The id can be any combination of up to 5
          characters.

        * HELP [I..] - with this argument help text may be defined
          which will be displayed as balloon help whenever the pointer
          is over the associated object. Of course, this is dependant
          on whether the user set up balloon help in the MUI preference
          settings.

        * NODE [I..] - this argument is used to specify a node in the
          guide file given in the command line argument HELP for
          `MUIRexx'.  If the user positions the mouse pointer over the
          object and presses the help button on the keyboard then the
          guide file will be displayed at the node location.

        * CLASS [I..] - this argument allows specification of the
          object class. The class may be any internal or external MUI
          or BOOPSI (see the BOOPSI option) gadget class.

        * BOOPSI [I..] - if this switch is given then the object will be
          created from a BOOPSI gadget class.  BOOPSI objects will, by
          default, have the following TAG ids and values set:

               TAG             value
               
               GA_Left         0
               GA_Top          0
               GA_Width        0
               GA_Height       0
               ICA_TARGET      ICTARGET_IDCMP

        * ATTRS [ISG] - with this option any MUIA attribute TAGs may be
          set or retrieved (see Attribute TAGs).

     Some useful TAGs for use with this command are:

          TAG_Name =                        TAG_id          Flags Type
          
          Boopsi_MaxHeight =                0x8042757f /* V4  isg ULONG */
          Boopsi_MaxWidth =                 0x8042bcb1 /* V4  isg ULONG */
          Boopsi_MinHeight =                0x80422c93 /* V4  isg ULONG */
          Boopsi_MinWidth =                 0x80428fb2 /* V4  isg ULONG */
          Boopsi_Remember =                 0x8042f4bd /* V4  i.. ULONG */
          Boopsi_Smart =                    0x8042b8d7 /* V9  i.. BOOL */
          Boopsi_TagDrawInfo =              0x8042bae7 /* V4  isg ULONG */
          Boopsi_TagScreen =                0x8042bc71 /* V4  isg ULONG */
          Boopsi_TagWindow =                0x8042e11d /* V4  isg ULONG */
          ControlChar =                     0x8042120b /* V4  isg char */
          CycleChain =                      0x80421ce7 /* V11 isg LONG */
          Disabled =                        0x80423661 /* V4  isg BOOL */
          Draggable =                       0x80420b6e /* V11 isg BOOL */
          FillArea =                        0x804294a3 /* V4  is. BOOL */
          FixHeight =                       0x8042a92b /* V4  i.. LONG */
          FixHeightTxt =                    0x804276f2 /* V4  i.. STRPTR */
          FixWidth =                        0x8042a3f1 /* V4  i.. LONG */
          FixWidthTxt =                     0x8042d044 /* V4  i.. STRPTR */
          HorizDisappear =                  0x80429615 /* V11 isg LONG */
          HorizWeight =                     0x80426db9 /* V4  isg WORD */
          MaxHeight =                       0x804293e4 /* V11 i.. LONG */
          MaxWidth =                        0x8042f112 /* V11 i.. LONG */
          Selected =                        0x8042654b /* V4  isg BOOL */
          ShowMe =                          0x80429ba8 /* V4  isg BOOL */
          ShowSelState =                    0x8042caac /* V4  i.. BOOL */
          VertDisappear =                   0x8042d12f /* V11 isg LONG */
          VertWeight =                      0x804298d0 /* V4  isg WORD */
          Weight =                          0x80421d1f /* V4  i.. WORD */
          
          Note: Consult MUI:Developer/Autodocs/MUI_Boopsi.doc, MUI_Area.doc and
                MUI:Developer/C/Include/libraries/mui.h

     Example use of this command:

          WHEEL_Hue =                       0x84000001
          WHEEL_Saturation =                0x84000002
          WHEEL_Screen =                    0x84000009
          
          window TITLE '"MUIRexx Demo"' COMMAND '"quit"' PORT DEMO
              group HORIZ
                  group
                      label DOUBLE '"Hue:"'
                      label DOUBLE '"Saturation:"'
                  endgroup
                  group
                      gauge ID HUE ATTRS Gauge_Max 16384,
                                         Gauge_Divide 262144,
                                         Gauge_Horiz TRUE
                      gauge ID SAT ATTRS Gauge_Max 16384,
                                         Gauge_Divide 262144,
                                         Gauge_Horiz TRUE
                  endgroup
              endgroup
              object ID BOOP BOOPSI CLASS '"colorwheel.gadget"',
                  ATTRS Boopsi_MinWidth 30,
                        Boopsi_MinHeight 30,
                        Boopsi_Remember WHEEL_Hue,
                        Boopsi_Remember WHEEL_Saturation,
                        Boopsi_TagScreen WHEEL_Screen,
                        WHEEL_Screen 0,
                        WHEEL_Saturation 0,
                        FillArea TRUE
              .
              .
              .
          endwindow
          
          method ID BOOP Notify WHEEL_Hue EveryTime,
                         @HUE 4 Set Gauge_Current TriggerValue
          method ID BOOP Notify WHEEL_Saturation EveryTime,
                         @SAT 4 Set Gauge_Current TriggerValue