
Any Resolution                POPUP.LST                  Any Resolution
                              ---------

The arc file should contain the following files:

     POPUP.LST      This is the main .LST file to be merged into your
                    program. It consists of 1 procedure called Popup().

     POPTEST.LST    This is a small file that can be merged above
                    POPUP.LST to test it does.

     POPTEST1.LST   This is another small test file.

     POPUP.TXT      Your reading it now.


               ---------------------------------------------

               GFA Basic is a trademark of GFA Systemtechnik.

              POPUP.LST is based on an Idea by John B. Holder.

               ---------------------------------------------


                              ------------
                              How it works.
-----------------------------------------------------------------------

     POPUP.LST consists of just 1 procedure that can be called as many
times as you wish. This does away with duplicate code. It can handle up
to 23 items in each window plus 1 title. Each of the items will be 
centered automatically along with the title.


                                Features
                                --------
1.   Works in all screen resolutions.
2.   Automatically centers title and items within the window. No need
     to pad with spaces or even worry about lengths. (78 M&H) (38 L)
     No need to worry about items being the same length.
3.   Automatically sets window size with title and item lengths.
4.   3 text sizes in mono (Hi rez). 2 text sizes in color (Med & Lo Rez)
5.   Popup at either mouse location or centered on the screen.
6.   Automatically makes sure the window is within the screen regardless
     of the mouse location.
7.   Simple procedure call that returns result in variable POPUP
     POPUP=0 means close box was clicked  POPUP=1 to 23 for item selected.

                              Setting it up.
                              -------------

     Just merge POPUP.LST into the editor. Thats all there is to it.

                                Using it.
                                --------

     Just call it up like you would any other procedure along with the
variable list that includes the title, items and whether or not you
wish the popup menu to be centered on screen or at the mouse position.




                              Calling it up.
                              -------------

     @Popup(Title$,Items$,Flag,Textsize)
                    or
     @Popup("Title","Item1,Item2,Item3",Flag,Textsize)


     Title$    can be any string$ or string variable.

     Items$    can be any string$ but must have the following format:

               Item1,Item2,Item3,,,,,,,,,,,,,,,,,, up to 23 items
               each item must be seperated by a comma.

     Flag      if Flag=0 the popup will be drawn at the mouse posistion.
               if Flag=1 the popup will be centered on the screen.

     Textsize  0 for normal, 1 for small and 2 for smaller.
               0,1 and 2 for Hi Rez   or    0 or 1 for Med and Lo Rez.

                              Example:
                              -------
Calling the procedure with:
--------------------------

@Popup("Test","Item 1,Item 2,Item 3,Item 4",1,0)


Will result in a popup that looks like this:
-------------------------------------------


                         -----------------
                         |/\|### Test ###|
                         -----------------
                         |     Item 1    |  (Kinda funny looking huh!)
                         |     Item 2    |  (Does not do it justice)
                         |     Item 3    |
                         |     Item 4    |
                         -----------------


And the popup will be centered on the screen.

Item selected will be returned in global variable POPUP

If Popup=0     Close box was selected.
If Popup=1-23  And Item was selected.

------------------------------------------------------------------------

If any questions contact:

Mike McCarley
-------------

SDACE BBS: 619-284-3821

