version 1
CT AREA TO AREA (source; destination; copyCode)
| Parameter | Type | Description | |
| source | Longint | Source 4D Chart area | |
| destination | Longint | Receives destination 4D Chart area | |
| copyCode | Integer | Items to copy | |
| 1 = Settings | |||
| 2 = Objects | |||
| 3 = Both |
Description
The CT AREA TO AREA command copies the contents of the 4D Chart area source into the 4D Chart area destination.
The contents to be transferred are based on the copyCode parameter.
If copyCode equals 1, the document settings such as display options are transferred.
If copyCode equals 2, all objects in source are transferred to destination.
If copyCode 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. CT AREA TO AREA is especially useful for manipulating offscreen areas.
Example
This example copies the contents of the 4D Chart area SalesChart into a new offscreen area.
vOffscreen:=CT New offscreen area CT AREA TO AREA (SalesChart;vOffscreen;3)
See Also
CT DELETE OFFSCREEN AREA, CT New offscreen area.