c2f08

Short:        pops up a window with a cyclegadget
Type:         os20/cli
Architecture: m68k-amigaos

   TYPE
     os20/cli

   NAME
     Cycle2Faust - pops up a window with a cyclegadget with specified items
                   and returns the selected

   SYNOPSIS
     Cycle2Faust NAME/A,TEXT/A,CYCLE/A/M,PUB/K,X/N,Y/N

   DESCRIPTION
     Cycle2Faust pops up a window with a cyclegadget with specified items
     and returns the selected. Cycle2Faust makes only sense with Cycle2Menu!

     Arguments are (first three required):

     -NAME  the name of the window that'll pop up

     -TEXT  the text above the cycle gadget

     -CYCLE the items in the cyclegadget. There is a limit of 10 items,
            i hope to remove this limit.
     -PUB   public sreen to pop up, if not given it'll be the default
            public screen (probably Workbench)
     -X,Y   x- and y-coordinates of the window

   USAGE
     Cycle2Faust "What should I do?" choose: Info Avail List NewShell >ENV:CH

     the environment variable $CH is set to your choice. Example see Demo sript

   SEE ALSO

   BUGS
     items limited to 10

   BACKGROUND
     Cycle2Faust was mainly written for demonstrating correct parsing of
     cyclegadget messages: gadtools returns the selected item in the code field
     of the message! It's false to interpret every click on a cyclegadget as
     a step forward, it maybe backward if the shiftkey is pressed or with
     Cycle2Menu it maybe a jump over 3 items. False interpreting of the message
     was done by GadToolsbox (it's fixed in V2 and i used it for this project),
     ReOrg V2.3 and Studio. Studio is a commercial product and I had a mail war
     with the author "Wolf Faust" (=> Cycle2Faust <=), he kept claiming
     Cycle2Menu is wrong and he's doing right. "Faust" is also the german word
     for fist. Cycle2Faust: my hands cycled to fists.


   AUTHOR
     Stefan Le Breton (slbrbbbh@w250zrz.zrz.tu-berlin.de)