7.114 SET_REF

Usage options

The SET_REF command is used to assign a component reference to a variable that has been defined with a dynamic reference in the DEFINE_COM statement. With a dynamic reference, an instance of a component is created only when a reference to it is assigned with the SET_REF command.

Beware of using long object names (i.e. Names) with this command.
SET_REF Com(#MyObject) To(*CREATE_AS #MyFormWithLongNames) works with long names.
SET_REF Com(#MyObject) To(*CREATE_FROM #MyFormWithLongNames) doesn't work as it is runtime and long names are not available.

Also See

7.114.1 SET_REF Parameters

7.114.2 SET_REF Examples

7.74 IF_REF


                                                           Required       

       SET_REF --- COM  ------- Variable name|variable name------->      

               >-- TO  -------- Reference expression ------------->       

               >-- CONTEXT  --- *DEFAULT  ------------------------>       
                                *OWNER                                    
                                *MODULE                                   
                                *NEW                                      
                                *NAMED ---- #Variable                     

               >-- COM_ERROR--- *ABORT ---------------------------|       
                                *IGNORE                                   
                                *SET_NULL