CT GET LEGEND ATTRIBUTES

4D - Documentation   Français   English   German   4D Chart, Command Theme List   4D Chart, Command Alphabetical List   Back   Previous   Next

version 1


CT GET LEGEND ATTRIBUTES (area; object; display; orientation; reverseOrder; reverseKey; location; horizOffset; vertOffset)

ParameterTypeDescription
areaLongint4D Chart area
objectLongintObject ID
displayIntegerIs legend displayed?
0 = No
1 = Yes
orientationIntegerReceives orientation of the series in the legend
0 = Horizontal
1 = Vertical
reverseOrderIntegerUsing reverse order?
0 = Not reversed
1 = Reversed
reverseKeyIntegerKey and text reversed?
0 = Not reversed
1 = Reversed
locationIntegerReceives location code
horizOffsetIntegerReceives horizontal offset from
plot's left side in points
vertOffsetIntegerReceives vertical offset from plot's
top side in points

Description

The CT GET LEGEND ATTRIBUTES command returns the attributes of the legend specified by area and object in the variables for the display, orientation, reverseOrder, reverseKey, location, horizOffset, and vertOffset parameters.

display specifies whether or not the legend is displayed.

orientation specifies whether the series in the legend are displayed vertically or horizontally with regard to each other. The following are examples of vertical and horizontal legends:

Vertical Legend Horizontal Legend

reverseOrder specifies whether the order of the series in the legend is reversed.

reverseKey specifies whether the series label and the key that explains the unique pattern and color of the series are reversed. The default is to show the key to the left of the label.

The following table lists the codes for the location parameter:

CodeLocation
0Legend's location is not one of the built-in locations
1Top left
2Bottom left
3Top right
4Bottom right
5Left
6Right
7Top
8Bottom

horizOffset and vertOffset are used when location is not one of the built-in legend locations (location = 0). horizOffset is expressed in points from the left side of the graph to the left side of the legend. vertOffset is expressed in points from the top of the graph to the top of the legend.

Note: To get the text attributes of legend text, use the CT GET CHART TEXT ATTRIBUTES command.

Example

This example gets the legend text attributes for the chart specified by $ChartID.

   CT GET LEGEND ATTRIBUTES (Area;$ChartID;$Display;$Orient;$ReverseO; $ReverseK;$Location;$HorizOff;$VertOff

See Also

CT GET CHART TEXT ATTRIBUTES, CT Get legend text, CT SET LEGEND ATTRIBUTES, CT SET LEGEND TEXT.


4D - Documentation   Français   English   German   4D Chart, Command Theme List   4D Chart, Command Alphabetical List   Back   Previous   Next