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 -------------------------------|