7.33 DEFINE_MAP

Note: Usage options

The DEFINE_MAP command defines the input and output value for an event, method or property routine.

The DEFINE_MAP statement is specified after the DEFINE_EVT statement or inside a MTHROUTINE or PTYROUTINE block. Input and output values have to be defined in separate DEFINE_MAP statements.

To pass more than one value to or from an event routine, you have to specify separate DEFINE_MAP statements for all of them in the DEFINE_EVT block. The same applies to method routines that can accept multiple input parameters. A property routine can have only one DEFINE_MAP statement for input and one for output because a property is always a single value.

Also See

7.33.1 DEFINE_MAP Parameters

7.33.3 DEFINE_MAP in MTHROUTINE

7.33.4 DEFINE_MAP in PTYROUTINE

7.33.2 DEFINE_MAP with DEFINE_EVT

7.91 MTHROUTINE

7.101 PTYROUTINE

7.32 DEFINE_EVT

 

                                                           Required       

                                                                          

    DEFINE_MAP --- FOR -------*INPUT ----------------------------->       

                              *OUTPUT                                     

                              *BOTH                                       

                              *RESULT                                     

                                                                          

                                                                          

               >---CLASS ------ Component Class ------------------>       

                               *Variant                                   

                                                                          

                                                                          

               >-- NAME ------- Component name  ------------------>       

                                                                          

               >-- PASS ------- *BY_VALUE  -------------------->          

                                *BY_REFERENCE                             

                                                                          

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

                                                                          

                                                         Optional         

                                                                          

                                                                          

               >-- DESC ------- Description  ----------------------->     

                                                                          

               >-- MANDATORY --*YES -------------------------------->     

                               *NULL                                      

                               Default value                              

                                                                          

               >-- HELP ------- Help text ---------------------------|