version 6.0
DR AREA TO AREA (source; destination; scope)
| Parameter | Type | Description | |
| source | Longint | Source 4D Draw area | |
| destination | Longint | Destination 4D Draw area | |
| scope | Longint | 1=Settings | |
| 2=Objects | |||
| 3=Both |
Description
The command DR AREA TO AREA copies the contents of the 4D Draw area source into the 4D Draw area destination based on the scope parameter.
If scope equals 1, the document settings such as drawing size, ruler settings, and display options are transferred.
If scope equals 2, all objects in source are transferred to destination.
If scope equals 3, both objects and document settings are transferred to destination.
When document settings are transferred, they replace the document settings in destination. When objects are transferred they are appended to the objects in destination. DR AREA TO AREA is especially useful for manipulating offscreen areas.
Example
The following example copies the contents of the 4D Draw area Diagram into a new offscreen area.
vOffscreen:=DR New offscreen area DR AREA TO AREA(Diagram;vOffscreen;3)
See Also
DR DELETE OFFSCREEN AREA, DR New offscreen area.