7.99 POP_UP

Note: Usage options

The POP_UP command displays information on a workstation in a pop up window.

The POP_UP command is only valid in RDMLX functions when being used on the Web. If it is used elsewhere a fatal error occurs at runtime. If this occurs, either put your POP_UP command in an RDML function or use a Form to show user information.

The POP_UP command is functionally very similar to the DISPLAY command, except that the information is presented in a window that overlays (or pops up over) information that is already on the screen.

For example, the following DISPLAY command:

   DISPLAY FIELDS(#CUSTNUM #NAME #ADDR1 #ADDR2 #ADDR3 #PHONE #ZIP)

might cause a panel to be presented on the workstation that looks something like this:

         Customer no  : 99999999
         Name         : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
         Address      : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                      : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                      : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
         Telephone    : 9999999999
         Zip          : 999999

If the following POP_UP command was then executed:

   POP_UP FIELDS(#DEBIT #CREDIT)

the resulting panel on the workstation might look something like this:

         Customer no  : 99999999
         Name         : XXXXXXXX ---------------------- XX
         Address      : XXXXXXXX |                    | XX
                      : XXXXXXXX | Debit  : 999999.99 | XX
                      : XXXXXXXX | Credit : 999999.99 | XX
         Telephone    : 99999999 |                    |
         Zip          : 999999   ----------------------

Portability Considerations

Refer to parameters: FIELDS , IGCCNV_KEY and TEXT .

Also See

7.99.1 POP_UP Parameters

7.99.2 POP_UP Comments / Warnings

7.99.3 POP_UP Examples


                                                                                                 Optional 

  POP_UP ---------- FIELDS ---------- field name    field attributes ------>
                                                          |                    |                       |     |
                                                          |                      --- 7 max ----      |
                                                          |  expandable group expression  |
                                                          |------ 1000 max for RDMLX-----|
                                                            ------- 100 max for RDML ----

                          >-- DESIGN -------- *ACROSS -------------------------->
                                                           *DOWN

                          >-- IDENTIFY ------- *LABEL ---------------------------->
                                                           *COLHDG
                                                           *DESC
                                                           *NOID

                         >-- IDENT_ATR ------ *DEFAULT ------------------------->
                                                           *NONE
                                                           *HI *RI *UL (3 maximum)

                         >-- DOWN_SEP ----- *DESIGN -------------------------->
                                                            decimal value

                         >-- ACROSS_SEP ---- *DESIGN -------------------------->
                                                           decimal value

                         >-- AT_LOC --------- *CENTRE --------------------------->
                                                    or   *QUAD1 *QUAD2 *QUAD3 *QUAD4
                                                    or   *UPPER *LOWER *LEFT *RIGHT
                                                    or   (row number    column number)

                         >-- WITH_SIZE ------ *AUTO ----------------------------->
                                                    or   (width   length)

                         >-- PANEL_ID ------- *AUTO ----------------------------->
                                                    or   *NONE
                                                    or   panel identifier

                         >-- PANEL_TITL ---- *FUNCTION ------------------------->
                                                    or   'Panel title'

                         >-- BROWSELIST --- *NONE ------------------------------>
                                                         name of list

                        >-- EXIT_KEY ------- *YES --- *EXIT --- *HIGH --- *NONE ->
                                                        *NO      *MENU    *LOW      condition
                                                                     *NEXT
                                                                     *RETURN
                                                                     label

                       >-- MENU_KEY ----- *YES --- *MENU-- *NONE ------------>
                                                        *NO       *EXIT       condition
                                                                      *NEXT 
                                                                      *RETURN
                                                                       label

                       >-- ADD_KEY ------ *NO ---- *NEXT -- *NONE ------------>
                                                       *YES       *RETURN condition
                                                                      label

                      >-- CHANGE_KEY -- *NO --- *NEXT -- *NONE ------------->
                                                       *YES      *RETURN condition
                                                                     label

                      >-- DELETE_KEY ---- *NO --- *NEXT -- *NONE ------------->
                                                       *YES     *RETURN   condition
                                                                    label

                     >-- PROMPT_KEY -- *DFT --- *AUTO -- *NONE ------------->
                                                     *YES       *NEXT     condition
                                                     *NO       *RETURN
                                                                   label

                     >-- USER_KEYS --- fnc key--'desc'--*NEXT -- *NONE ------->
                                                  |                         *RETURN   cond            |
                                                  |                          label                            |
                                                  |                                                              |
                                                    ------------ 5 maximum ---------------

                    >-- SHOW_NEXT -- *PRO ----------------------------------->
                                                    *YES
                                                   *NO

                    >-- TEXT —-------- 'text' ------ line/ ------ position -------->
                                                  |                   row            column              |
                                                     -------------- 50 max ----------------
                                                       *TMAPnnn  1  1  (special value)

                   >-- CURSOR_LOC -- *NONE  --------- *NONE -------------->
                                                   *ATFIELD               field name
                                                   row value             column value

                   >-- STD_HEAD ----- *DFT ------------------------------------>
                                                   *YES
                                                   *NO

                  >-- IGCCNV_KEY  -- *AUTO -----------------------------------|
                                                  *YES
                                                  *NO
                                                  condition name