version 2003
PA_VirtualStructureDefined char
Parameter | Type | Description | |
This command does not require any parameters | |||
Function result | char | 1 if virtual sructure is defined, else 0 |
Description
The command PA_VirtualStructureDefined returns 1 if the virtual structure is defined in 4th Dimension, otherwise it returns 0.
By default, real structure is used, and you can tell 4D to switch between virtual and real structure by calling PA_UseVirtualStructure and PA_UseRealStructure.
Note that PA_VirtualStructureDefined returns 1 if 4D itself knows about virtual structure, it does not depend of the last call to PA_UseVirtualStructure and PA_UseRealStructure.
Once you know if the virtual structure mode is defined, you can call routines that return information about the true/virtual tables and fields number, such as PA_GetTrueTableNumber, PA_GetVirtualTableNumber.
The virtual structure is used when the 4D commands SET TABLE TITLES and SET FIELD TITLES are called.
Example
See PA_UseVirtualStructure for an example of use.
See Also
PA_GetTrueFieldNumber, PA_GetTrueTableNumber, PA_GetVirtualFieldNumber, PA_GetVirtualTableNumber.
Error Handling
PA_GetLastError always returns eER_NoErr