version 1
CT Area to picture (area; scope) PIcture
Parameter | Type | Description | |
area | Longint | 4D Chart area | |
scope | Longint | Scope of the function | |
-2 = Document | |||
-1 = All | |||
0 = Selected objects | |||
>0 = Object ID | |||
Function result | PIcture | 4th Dimension picture of the objects in area |
Description
CT Area to picture returns a 4th Dimension picture of the objects in area.
The objects included in the picture are controlled by the scope parameter.
If scope equals -2, the entire document is copied. This includes document settings such as display options.
If scope equals -1, all objects in area are copied but without document settings.
If scope equals 0, only the selected objects are copied.
If scope is greater than 0, it must equal a specific object's ID and only that object is copied.
Example
This example opens a new offscreen area, creates a bar chart from existing arrays, stores the chart in a picture variable, and finally, deletes the offscreen area.
Area:=CT New offscreen area vChart:=CT Chart arrays (Area;2;2;aCategory;aSeries;aValues) vPict:=CT Area to picture (Area;vChart) CT DELETE OFFSCREEN AREA (Area)
See Also
CT Get ID, CT PICTURE TO CLIPBOARD, CT Place picture.