>  Docs Center  >  IDL Reference  >  Object Graphics - Visualization  >  IDLgrLegend Properties

IDLgrLegend Properties

IDLgrLegend Properties

IDLgrLegend objects have the following properties in addition to properties inherited from any superclasses. Properties with the word “Yes” in the “Get” column of the property table can be retrieved via IDLgrLegend::GetProperty. Properties with the word “Yes” in the “Init” column of the property table can be set via IDLgrLegend::Init. Properties with the word “Yes” in the “Set” column in the property table can be set via IDLgrLegend::SetProperty.

Note: For a discussion of the property description tables shown below, see Modifying Object Property Descriptions.

Objects of this class have the following properties.

In addition, objects of this class inherit:

ALL

An anonymous structure containing the values of all of the retrievable properties associated with this object.

Property Type

Structure

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No

BORDER_GAP

A floating-point value to indicate the amount of blank space to be placed around the outside of the glyphs and text items. The units for this property are fractions of the legend label font height. The default is 0.1 (10% of the label font height).

Property Type

Floating-point

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

COLUMNS

An integer value to indicate the number of columns the legend items should be displayed in. The default is one column.

Property Type

Integer

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

FILL_COLOR

The color to be used to fill the legend background box. The color may be specified as a color lookup table index or as a three-element vector [red, green, blue]. The default is [255,255,255].

Property Type

COLOR

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

FONT

An object reference to an instance of an IDLgrFont object class that describes the font to use to draw the legend labels. The default is 12 point Helvetica.

Note: If the default font is in use, retrieving the value of the FONT property (using the GetProperty method) will return a font object that will be destroyed when this legend object is destroyed, leaving a dangling object reference.

Note: Objects specified via this property are not automatically cleaned up when the IDLgrLegend object is destroyed.

Property Type

Object reference

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

GAP

A floating-point value that indicates the amount of blank space to be placed vertically between each legend item. The units for this property are fractions of the legend label font height. The default is 0.1 (10% of the label font height). The same gap is placed horizontally between the legend glyph and the legend text string.

Property Type

Floating-point

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

GLYPH_WIDTH

A floating-point value to indicate the width of the glyphs, measured as a fraction of the font height. The default is 0.8 (80% of the font height).

Property Type

Floating-point

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

HIDE

A Boolean value that indicates whether this object should be drawn:

  • 0 = Draw graphic (the default)
  • 1 = Do not draw graphic

Property Type

Boolean

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_COLOR

An array of colors defining the color of each item. The array defines M different colors, and should be either of the form [3,M] or [M]. In the first case, the three values are used as an RGB triplet, in the second case, the single value is used as a color index value. The default color is [0,0,0].

Property Type

Color array

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_LINESTYLE

An integer array of integers defining the style of the line to be drawn if the TYPE property is set to zero. The array can be of the form [M] or [2,M]. The first form selects the linestyle for each legend item from the predefined defaults.

To use a pre-defined line style, set this property equal to one of the following integer values:

0

Solid line (the default)

1

Dotted

2

Dashed

3

Dash dot

4

Dash dot dot dot

5

Long dash

6

No line drawn

The second form specifies the stippling pattern explicitly for each legend item (see the LINESTYLE property to IDLgrPolyline::Init for details).

Property Type

Integer array

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_NAME

An string array representing the names of items in the legend.

Specifying this property is the same as specifying the optional aItemNames argument to the IDLgrLegend::Init method.

Property Type

String array

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_OBJECT

An array of object references of type IDLgrSymbol or IDLgrPattern that represents the shapes of the items in the legend. A symbol object is drawn only if the TYPE property is set to zero. A pattern object is used when drawing the color patch if the TYPE property is set to one. The default object is the NULL object.

Note: If one or more IDlgrSymbol object references are provided, the SIZE property of those objects may be modified by this legend to suit its layout needs.

Note: Objects specified via this property are not automatically cleaned up when the IDLgrLegend object is destroyed.

Property Type

Object reference array

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_THICK

A floating-point array of floating-point values that define the thickness of each item line, in points, where each element is a value between 0.0 and 10.0. A thickness of 0 displays a thin hairline on the chosen device. Out-of-range values are quietly clamped to the allowed range. This property is only used if the TYPE property is set to zero. The default is 1.0 points.

Property Type

Floating-point

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ITEM_TYPE

An integer array that defines the type of glyph to be displayed for each item:

  • 0 = line type (the default)
  • 1 = filled box type

Property Type

Integer array

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

OUTLINE_COLOR

The color to be used to draw the legend outline box. The color may be specified as a color lookup table index or as a three-element vector [red, green, blue]. The default is [0,0,0].

Property Type

Color

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

OUTLINE_THICK

A floating-point value between 0.0 and 10.0 that defines the thickness of the outline frame, in points. A thickness of 0 displays a thin hairline on the chosen device. Out-of-range values are quietly clamped to the allowed range. The default is 1.0 points.

Property Type

Floating-point

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

PARENT

An object reference to the object that contains this legend.

Property Type

Object reference

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No

RECOMPUTE

A Boolean value that determines whether to recompute the legend dimensions when the legend is redrawn.

  • 0 = Prevent IDL from recomputing legend dimensions (the default).
  • 1 = Recompute the legend dimensions when the legend is redrawn.

Property Type

Boolean

Name String

not displayed

Get: No

Set: Yes

Init: No

Registered: No

SHOW_FILL

A Boolean value that indicates whether the background should be filled with a color:

  • 0 = Do not fill background (the default)
  • 1 = Fill background

Property Type

Boolean

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

SHOW_OUTLINE

A Boolean value indicating whether the outline box should be displayed:

  • 0 = Do not display outline (the default)
  • 1 = Display outline

Property Type

Boolean

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

TEXT_COLOR

The color to be used to draw the legend item text. The color may be specified as a color lookup table index or as a three-element vector [red, green, blue]. The default is [0,0,0].

Property Type

Color

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

TITLE

An object reference to an instance of the IDLgrText object class to specify the title for the legend. The default is the null object, specifying that no title is drawn. The title will be centered at the top of the legend, even if the text object itself has an associated location.

Note: Objects specified via this property are not automatically cleaned up when the IDLgrLegend object is destroyed.

Property Type

Object reference

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

XCOORD_CONV

A floating-point vector, [s0, s1], of scaling factors used to convert X coordinates from data units to normalized units. The formula for the conversion is as follows:

NormalizedX = s0 + s1 * DataX

Recommended values are:

[(-Xmin)/(Xmax-Xmin), 1/(Xmax-Xmin)]

The default is [0.0, 1.0]. IDL converts, maintains, and returns this data as double-precision floating-point.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

XRANGE

A two-element double-precision floating-point vector of the form [xmin, xmax] that specifies the range of the X data coordinates covered by the legend.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No

YCOORD_CONV

A floating-point vector, [s0, s1], of scaling factors that convert Y coordinates from data units to normalized units. The formula for the conversion is as follows:

NormalizedY = s0 + s1 * DataY

Recommended values are:

[(-Ymin)/(Ymax-Ymin), 1/(Ymax-Ymin)]

The default is [0.0, 1.0]. IDL converts, maintains, and returns this data as double-precision floating-point.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

YRANGE

A two-element double-precision floating-point vector of the form [ymin, ymax] that specifies the range of the Y data coordinates covered by the legend.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No

ZCOORD_CONV

A floating-point vector, [s0, s1], of scaling factors that convert Z coordinates from data units to normalized units. The formula for the conversion is as follows:

NormalizedZ = s0 + s1 * DataZ

Recommended values are:

[(-Zmin)/(Zmax-Zmin), 1/(Zmax-Zmin)]

The default is [0.0, 1.0]. IDL converts, maintains, and returns this data as double-precision floating-point.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

ZRANGE

A two-element double-precision floating-point vector of the form [zmin, zmax] that specifies the range of the Z data coordinates covered by the legend.

Note: Until the legend is drawn to the destination object, the [XYZ]RANGE properties will be zero. Use the ComputeDimensions method on the legend object to get the data dimensions of the legend prior to a draw operation.

Property Type

Floating-point vector

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us