PA_UseVirtualStructure

version 2003

PA_UseVirtualStructure

The command PA_UseVirtualStructure tells 4D to henceforth use the virtual structure references (if supported) in all pending API calls.

By default, real structure is used. Note that this affects many API routines, in fact all routines using tables/fields numbers or names.

To know if the virtual structure mode is supported by 4D, call PA_VirtualStructureDefined . If it returns 1 then APIs of the Virtual structure theme can be used safely, otherwise they will not work or will return an error code.

The virtual structure is used when the 4D commands SET TABLE TITLES and SET FIELD TITLES are called.

We want to temporarily work with virtual table numbers.

   //... previous code...
   if(PA_VirtalStructureDefined())
   {
      PA_UseVirtualStructure();
   //...all pending calls will use virtual structure
   // switch back to real structure
      PA_UseRealStructure();
   }
   else
   // Virtual structure not supported: Alert user, returns error, etc.

PA_UseRealStructure .

None