Siebel Reports Administration Guide > Using Graphics in Reports >

Graph Control Properties


The property settings for a graph control are set in the Component Editor. To access this, right-click the graph, choose Properties from the pop-up menu, and click the Properties tab. Summary and detail graphs have the same set of available properties, with the exception of the properties in the Expressions category, which differ between the two types.

The properties for a graph control, arranged by property category (the folder you must expand to view the property), are described in Table 6.

Table 6.  Graph Properties by Property Category
Category
Property
Description
 
TargetWindow Name
The name of the target window in which the contents of a hyperlink appear.
Advanced
LinkExp
The expression defining a hyperlink for this graph object.
ObjectVariable
The name of an optional method in the frame that will point to this graph object.
Data
DataSetCount
The number of data series. This value is computed when the graph is displayed. When you are designing the graph, this property contains the number of sample points to show.
PointCount
The number of points in each data series. This value is computed when the graph is displayed. When you are designing the graph, this property contains the number of sample points to show.
PointLabelColor
The color of the labels displayed for each point.
PointLabelStyle
The style of the labels displayed for each point. Options are GraphNoPointLabels, GraphCustomLabels, GraphNumericLabels, GraphColoredNumericLabels, and GraphColoredCustomLabels.
SampleMax
Maximum for the sample values.
SampleMin
Minimum for the sample values.
ValuesColorList
A comma-separated list of color names or RGB values to identify different data series.
Expressions (in AcDetailGraph only)
LabelValueExp
Contains a data row variable, in square brackets, from which a text x-axis label can be obtained for each point. Note that values are not aggregated for each label.
XValueExp
Contains a data row variable, in square brackets, that supplies the X value for each data point. For example, in a scatter graph that plots revenue on the y-axis against sales stage on the x-axis, the setting for this property would be [ssSales_Stage].
YValueExp
Contains a data row variable, in square brackets, that supplies the Y value for each data point. For example, in a scatter graph that plots revenue on the y-axis against sales stage on the x-axis, the setting for this property would be [ssRevenue].
ZValueExp
Contains a data row variable, in square brackets, that supplies the Z value (series) for each data point.
Expressions (in ssSummaryGraph only)
CategoryKey
Contains a data row variable or expression that specifies the category, that is, the x-axis value that groups data. This should normally evaluate to an integer. For example, in a summary graph that groups opportunities by month, the category key would be:
Year([ssClose_Date]) * 12 + Month([ssClose_Date]) -1
CategoryLabel
Contains a data row variable or expression that provides the text label for each category. For example, in a summary graph that groups opportunities by month, the category label expression would be:
[ssClose_Date_ Formatted]
SeriesKey
Contains a data row variable or expression that specifies the series (z-axis) for the data point, that is, the value that determines which bar color or line graph curve the point appears in. This should normally evaluate to an integer.
SeriesLabel
Contains a data row variable or expression that provides the text label to appear in the legend for each series.
ValueExp
Contains a data row variable or expression that supplies the Y value for each data point. For example, in a summary graph that displays opportunity revenue by month, the value expression would be:
Sum(Val([ssRevenue]))
General
AxisColor
Color of the axis lines.
BackgroundColor
Background color of the graph. Ignored if BackgroundIsClear is TRUE.
BackgroundIsClear
TRUE if the background of the graph is clear.
GraphBackground. Color
Color of the rectangle around the graph.
GraphBackgroundIsClear
TRUE if the rectangle around the graph itself (not including titles or the legend) is clear.
GraphBorderStyle
Style for the border around the graph. Options are GraphNoBorder, GraphSolidBorder, GraphDropShadow, GraphShadowAndBorder, GraphRaisedBorder, and GraphLoweredBorder.
GraphType
Specifies the graph type. Options are Graph2DPie, Graph3DPie, Graph2DBar, Graph3DBar, GraphLine, Graph2DArea, Graph2DScatter, GraphHLC, GraphTape, GRaphOHLC, Graph2DArea, and Graph3DArea.
GridColor
Color of the grid lines superimposed on the graph.
Graph-Specific
BarGrouping
Specifies that a bar chart is clustered, stacked, or without clustering or stacking. Ignored for charts other than bar charts. Options are GraphBarNoGrouping, GraphBarCluster, GraphBarClusterZ (3D only), GraphBarStack, and GraphBarStackPercentage.
BarOrientation
Specifies that a bar chart has horizontal or vertical bars. Ignored for charts other than bar charts. Options are GraphBarVertical, GraphBarHorizontal, and GraphBarHorizontalReversed.
Graph-Specific
(continued)
HLCBarStyle
HLC and OHLC graphs only. Determines how the graph displays high, low, and close tick marks. Options are GraphHLCAllBars, GraphHLCThickBars, GraphHLCNoClose, and GraphHLCNoBars.
LineStyle
Specifies that a line graph has solid lines of default thickness, broken lines of a particular pattern, or thick lines. Applies to line graphs only. Options are GraphDefaultLines, GraphPatternLines, and GraphThickLines.
LineStylesList
Line graphs only. A comma-separated list of line styles, one style for each data set. Options are SingleLine, DashLine, DotLine, DashDotLine, DashDotDotLine, and NullLine.
LineThickness
Line and scatter graphs only. Specifies the thickness of lines in graph-specific units.
PointsArePercent
Area graphs only. TRUE indicates that the numbers on the data points are percentage figures. FALSE indicates that the points are absolute numbers.
ShowAsPercent
Area graphs and pie charts only. Draws the graph showing the percentage of each data point as the sum of all points in that dataset. The area always fills the full graph height.
ShowLines
Line, log/lin, lin/log, and log/log graphs only. TRUE shows lines connecting the points.
ShowSticks
Line, log/lin, lin/log, log/log, and scatter graphs only. TRUE shows lines from the y-axis to each point.
ShowSymbols
Line, log/lin, lin/log, log/log, and scatter graphs only. TRUE shows symbols for each point.
HTML
Alignment
Specifies the alignment of the graph window within the flow of text in the report.
AlternateText
In browsers that do not support Java applets, specifies the text that appears in place of the graph.
BorderWidth
The number of pixels of thickness of the border around the graph.
Margin
The number of pixels of horizontal and vertical space between the window and the surrounding text.
UseDefaultSize
Determines whether to use the default image size computed by the browser. If it is set to TRUE, the system does not generate the height and width HTML attributes. If FALSE, the system generates these attributes from the Size property.
Legend
LegendBackgroundColor
Background color for the legend.
LegendBackground IsClear
TRUE if the legend is transparent.
LegendBorderStyle
The style of the box to draw around the legend. Options are GraphNoBorder, GraphSolidBorder, GraphDropShadow, GraphShadowAndBorder, GraphRaisedBorder, and GraphLoweredBorder.
LegendColorText
TRUE if the legend entries are the same color as the lines, points, or bars they identify. FALSE if they are all the color given by Legend.LegendFont.Color.
LegendFont
A group of properties that defines the font of the legend labels, including Bold, Color, FaceName, Italic, and so on.
LegendPosition
The position of the legend. Options are GraphLegendNone, GraphLegendTop, GraphLegendTopRight, GraphLegendTopLeft, GraphLegendLeft, GraphLegendRight, GraphLegendBottomLeft, GraphLegendBottom, and GraphLegendBottomRight.
LegendSize
The relative size of the legend, from 0 (smallest) to 100 (largest). This value controls the spacing of legend entries.
Titles
AxisTitleFont
A set of properties that defines the font of the x- and y-axis titles.
LabelFont
A set of properties that defines the font for the x- and y- axis values labels, and that of the data labels adjacent to each point.
TitleBackground Color
Background color for the rectangle enclosing the title.
TitleBackgroundIsClear
TRUE indicates that the area under the title should be transparent.
TitleBorderStyle
Style for the border around the title. Options are GraphNoBorder, GraphSolidBorder, GraphDropShadow, GraphShadowAndBorder, GraphRaisedBorder, and GraphLoweredBorder.
TitleFont
A set of properties that defines the font for the graph title.
TitleText
Title that appears above the graph.
TOC
TocAddComponent
Determines whether the component name is added to the report's table of contents. The values are:
TOCAlwaysAdd. Always add the component to the table of contents.
TOCIfAllVisible. Add component name to the table of contents only if the user can view at least one page generated from the component based on page security. This is the default.
TOCIfAnyVisible. Add component to table of contents even if the user cannot view any pages generated from the component based on page security.
TOCSkip. Never add the component to the table of contents. Use this to hide components such as parallel or sequential sections or detail frames from the user.
TocAddContents
Determines whether the component's contents are added to the report's table of contents.
TocValueExp
Returns a string to show as the table of contents entry for this object.
Viewing
CursorShape
The kind of cursor to show when the mouse cursor passes over the graph object.
HelpText
The text to show for this graph object when the user asks for help.
Searchable
Specifies whether the graph object can be searched in the Viewer.
SearchAlias
The name to display to the user when building a search for this graph object.
Selectable
TRUE if the user can select this graph object in the Viewer.
Visual
Position
The position of the graph object in its enclosing frame.
Size
The size of the graph object.
X-Axis
XAxisPosition
The position of the x-axis. Options are GraphXAxisAuto, GraphXAxisTop, and GraphXAxisBottom.
XAxisStyle
The location of the graph origin. Options are GraphZeroOrigin, GraphAutoOrigin, and GraphCustomOrigin.
XLabelFormat
The format string used to create custom x-axis labels.
XLabelsList
A comma-separated list of quoted x-axis values.
XLabelStyle
The kind of labels to show along the x-axis. Options are the following:
GraphNoLabels. Displays no labels.
GraphAutoLabels. Displays labels computed automatically.
GraphCustomLabels. Displays custom labels based on the information you enter in the XLabelsList property.
GraphExpressionLabels. Displays labels computed from an expression you specify in the LabelExp property.
XMajorGridStyle
The style of line to draw for the major grid lines. Options are SingleLine, DashLine, DotLine, DashDotLine, DashDotDotLine, and NullLine.
X-Axis
(continued)
XMajorTickCount
The number of ticks to display. For graphs with X values, this is the number of ticks to display. For graphs without X values, this is the frequency of the ticks (that is, points per tick).
XMajorTickStyle
The kind of tick marks to include. Options are GraphNoTicks, GraphAutoTicks, and GraphCustomTicks.
XMax
Sets the maximum x-axis limit. This value is computed when the graph is displayed. When the graph is being designed, this value is used for displaying sample data.
XMin
Sets the minimum x-axis limit. This value is computed when the graph is displayed. When the graph is being designed, this value is used for displaying sample data.
XMinorGridStyle
The style of line to draw for the minor grid lines.
XShowMinorTicks
TRUE indicates that the graph displays minor tick marks. If so, there will always be five minor tick marks between two major tick marks.
XTitle
The text of the label to show for the x-axis.
XTitleBackGround Color
The background color of the x-axis title.
XTitleBackgroundIsClear
TRUE specifies that the x-axis title background is transparent.
XTitleBorderStyle
The style of the rectangle that encloses the x-axis title. Options are GraphNoBorder, GraphSolidBorder, GraphDropShadow, GraphShadowAndBorder, GraphRaisedBorder, and GraphLoweredBorder.
XValueSet
Indicates how the system should determine how many x-axis values are available.
GraphDefaultXValues. No x-axis values are available; the graph should provide default spacing along the x-axis.
GraphXValuePerDataSet. There is one set of x-axis values provided in the points for the first (or only) data set that apply to all points.
GraphXValuePerPoint. Each point has its own X value.
XVerticalLabels
TRUE to show x-axis labels vertically instead of horizontally.
Y-Axis
YAxisPosition
The position of the y-axis. Options are GraphYAxisAuto, GraphYAxisLeft, and GraphYAxisRight.
YAxisStyle
The location of the graph origin. Options are GraphZeroOrigin, GraphAutoOrigin, and GraphCustomOrigin.
YLabelFormat
The format string used to create custom y-axis labels.
YLabelsList
A comma-separated list of quoted y-axis values.
YLabelStyle
The kind of labels to show along the y-axis. Options are the following:
GraphNoLabels. Displays no labels.
GraphAutoLabels. Displays labels computed automatically.
GraphCustomLabels. Displays custom labels based on the information you enter in the XLabelsList property.
GraphExpressionLabels. Displays labels computed from an expression you specify in the LabelExp property.
YMajorGridStyle
The style of line to draw for the major grid lines. Options are SingleLine, DashLine, DotLine, DashDotLine, DashDotDotLine, and NullLine.
YMajorTickCount
The number of ticks to display. For graphs with y-axis values, this is the number of ticks to display. For graphs without y-axis values, this is the frequency of the ticks.
YMajorTickStyle
The kind of tick marks to include. Options are GraphNoTicks, GraphAutoTicks, and GraphCustomTicks.
Y-Axis
(continued)
YMax
Sets the maximum y-axis limit. This value is computed when the graph is displayed. When the graph is being designed, this value is used for displaying sample data.
YMin
Sets the minimum y-axis limit. This value is computed when the graph is displayed. When the graph is being designed, this value is used for displaying sample data.
YMinorGridStyle
The style of line to draw for the minor grid lines. Options are GraphDefaultLines, GraphPatternLines, and GraphThickLines.
YShowMinorTicks
TRUE indicates that the graph displays minor tick marks. If so, there will always be five minor tick marks between two major tick marks.
YTitle
The text of the label to show for the y-axis.
YTitleBackGround Color
The background color of the y-axis title.
YTitleBackgroundIsClear
TRUE means the y-axis title background is transparent.
YTitleBorderStyle
The style of the rectangle that encloses the y-axis title. Options are GraphNoBorder, GraphSolidBorder, GraphDropShadow, GraphShadowAndBorder, GraphRaisedBorder, and GraphLoweredBorder.
YTitleOrientation
Determines how the text appears for the y-axis title. The default is GraphYLabelUp, which rotates the text 90 degrees counterclockwise. Options are GraphYLabelHoriz, GraphYLabelUp, and GraphYLabelDown.
YVerticalLabels
TRUE to show x-axis labels rotated 90 degrees.


 Siebel Reports Administration Guide, Version 7.5, Rev B 
 Published: 18 April 2003