Graph Properties

This dialog allows you to change settings directly related to the currently selected graph. It is accessed by selecting a graph and then selecting Properties > Graph Properties. Depending on the graph type, some or all of the following options may be available. Where appropriate, the graphs that these options affect are listed to the right of the option header.

For more information about Graph Types, refer to Chapter 13, "Graph Types," in the PopChart Server Reference manual.

General

This pane controls general graph formatting and display options.

Graph Formatting (All Graphs)

This controls how the graph object is formatted in regards to tick marks and labels.

Keep Text and Ticks Within Graph Bounds
This setting keeps scale labels and tick marks within the graph object's boundaries. As the text in scale labels grows, the graph's grid area will shrink to compensate.
Allow Text and Ticks Outside of Bounds
This setting moves the scale labels and tick marks outside of the graph object's boundaries. This means that the graph's grid area will always be the same size, regardless of the scale label text. This setting makes it easier to overlap graphs, since it guarantees that same-sized graph objects will have grid areas of the same size.

Outline Type (Bar, Line Bar)

This allows you to apply an outline to your bars. By default, there will be no outline (None). The other options are Lighter and Darker and Color.

Color
Launches the Color Properties dialog, where you can change the PopUp text border color. For more information about this dialog, refer to "Color Properties" in Chapter A.

Single Series Multicolor Mode (Bar)

In the event that there is only one series of data, checking this will make the graph display each item in the series in a different color instead of in the same color. Otherwise this will have no effect. This setting does not apply to Stacked Bar graphs.

Space Between Bars (Bar, Line Bar, Pareto)

Specifies the amount of white space between each bar in a Bar graph as a percentage of the Bar Width. You can choose from three default settings, or specify another setting by selecting Other and manually entering the percentage of white space.

Bar Width (Bar, Line Bar, Pareto)

Specifies the width of the bars in a Bar graph as a percentage of the category width. You can choose from three default settings, or specify another setting by selecting Other and manually entering the percentage of white space. This setting does not apply to Stacked Bar graphs.

Manually Set Number of Lines (Line Bar)

By default, the series of data in a Line Bar Combo graph are divided evenly into lines and bars. Checking this setting allows you to specify the number of series that should be represented as lines. For example, if you check this box and type in 3 as the Number of Lines, the first three series of data will be shown as lines, while all of the other series will be shown as bars.

Floating Bars (Stacked Bar)

Renders the last series, which is represented by the bottom segment of a Stacked Bar graph, invisible. This makes the bar appear to be floating.

Show Graph Label (PIE)

When this is checked, a label will appear above the Pie graph. This label corresponds with the category label for the category that is being graphed.

Graph Style (Pie)

This option allows you to choose from three different ways of displaying a Pie graph: 2D, 2D with Gaps, and 3D. The picture above each setting will give you an idea of the effect.

Sort Data (X-Y Plot, Time Plot)

Tells the X-Y Plot graph to draw a line connecting plot points according to the order of their x values as opposed to the order in which they appear on the spreadsheet.

Warning: Do not use PopUp text when you select this option. PopUp text will not work correctly.

Bubble Size (Bubble)

Allows you to scale the size of the bubbles in your graph. This can be useful if you have extremely large or small bubble values.

Value Represented By (Bubble)

Changes how PopChart Builder uses the bubble value to determine the size of the bubble. If set to Width of Bubbles, PopChart Builder will use your bubble value as the diameter of the bubbles. If set to Area of Bubbles, PopChart Builder will use your bubble value as the area of the bubbles.

Show Weekly Grids On (Time Plot)

Selects the day of the week on which minor gridlines should occur. This can be especially useful if you need your gridlines to correspond to Monday for the start of the business week instead of Sunday.

This setting only affects graphs where the range of the time scale is such that the minor gridlines fall on each week. For graphs with a larger time scale (generally, any range larger than six months, with dates occuring over more than one calender year), or a smaller time scale (generally, a range smaller than two months) this setting has no effect.

Date Input Format (Time Plot)

This box allows you to change the data input format string.

This string determines how PopChart Builder and PopChart Server translate your data values to actual time values. It uses macros to indicate different values, such as month, day, or minute. You can also enter static text if your time values contain slashes or colons

For example, the default format is %m/%d/%Y. this means that when you enter data into the Data Editor, or when you send to PopChart Server dynamically, you should enter the month, followed by a slash, followed by the day, followed by a slash, followed by the four digit year (e.g. 12/31/2001).

As another example, suppose all of the time values you are graphing occur on the same day, and you just want to enter the hour and minutes (e.g. 9:30, 10:00, 14:15, etc). To do this, you would choose %H:%M as your date input format.

The table below this box on the dialog screen indicates what time macros PopChart Builder accepts. A list is also available on page 5-17 of the PopChart Server Reference manual.

Series Transparency (Radar)

Sets the transparency of the area fill for a radar graph. Radar graphs use transparency so that you can see data items below the top data item.

Gridlines (All Except Pie, Pareto, Gauges)

This pane controls settings for the gridlines behind the currently selected graph object. On the left you will find a series of check boxes. Each box, when checked, enables the gridline indicated by the name to the right of the box. The image on the right side of the pane shows you which gridlines correspond to what name. To the left of each check box is a color button. Clicking on these buttons will bring up the Color Properties dialog (refer to "Color Properties"), from which you can select a different color for the corresponding gridline.

Drill-down

This pane controls options for drill-down effects in the currently selected graph. For information about Drill-down effects, refer to "Drill-down Effects" in Chapter 7 of the PopChart Server User Guide.

Drill-down URL

This sets a global drill-down destination for the data items in your graph. This is the URL (internet address) of the web page or resource to which the user will be forwarded when he or she clicks on a data item. You can also use JavaScript instead of a URL. This string can contain any macros listed in the Value Keywords box below.

If set, all data items will drill-down to this destination unless you specify otherwise in the Series Properties > Drill-down URLs dialog pane, or dynamically with the graph. DDEnable() method.

For information about the global drill-down effects and macros, refer to "Global Drill-down Settings and Macros" in Chapter 1.

Value Keywords

This is a list of macros that can be used in the drill-down metastring. You can insert any of these macros into the drill-down URL box above by selecting the appropriate macro and clicking on the Insert button. A complete list of these macros is available in Table 1.2 on page 1-15.

Method for Highlighting Non-Text Items

This option changes the method for highlighting non-text items, such as bars or pie wedges, that have been enabled for drill-down effects. You can choose from the following options:

OutLine
A single line outlines the drill-down area as the mouse passes over it.
Bold OutLine
A double line outlines the drill-down area as the mouse passes over it.
Color Change
The drill-down area changes color as the mouse passes over it. It will change to a lighter shade of its current color. Note that this means the user will be unable to see the color change on white objects. This only applies to certain graphs.

Color for Text Highlighting

When drill-down is enabled for a text item, the color of the text item will change to the color shown in the color button. To change this color, click on the button. This will bring up the will bring up the Color Properties dialog (refer to "Color Properties"), from which you can select a color.

PopUp

This pane controls the format of PopUp text in the currently selected graph. PopUp text will appear as a user rolls his or her mouse over a data item. For more information about PopUp text, refer to "PopUp Text" in Chapter 7 of the PopChart Server User Guide.

Note: These settings do not change the way popup is displayed for GIF images.

Justification

Changes the justification of the PopUp text. Settings include: left, center, and right. The effects of this setting will only be seen when there are multiple lines of PopUp text.

Margin Values

These values set the margin between the actual PopUp text and the edge of the PopUp text box.

Top
Sets the space in pixels between the top of the text and the top edge of the text box.
Left
Sets the space in pixels between the left edge of the text and the left edge of the text box.
Bottom
Sets the space in pixels between the bottom of the text and the bottom edge of the text box.
Right
Sets the space in pixels between the right edge of the text and the right edge of the text box.

Set Word Wrapping Width To

If checked, this box specifies that the PopUp text box should be no wider than the number of pixels indicated in the box below. If the PopUp text is wider than this value, it will automatically wrap and form another line inside of the PopUp text box.

Show Border

If checked, the PopUp text box will be surrounded by a border.

Border Color
Allows you to change the color of the PopUp text box. Clicking on it brings up the Color Properties dialog (refer to "Color Properties").

Font

This button will launch a Font Properties dialog, where you can change the font of the PopUp text for the graph. For more information about this dialog, refer to "Font Properties" in Chapter A.

Notes

This pane controls the format of dynamically created (not static) PopChart Notes in the currently selected graph. For more information, refer to "PopChart Notes".

Layout Notes

This sets how PopChart Server will try to lay out your dynamically created PopChart Notes. The available options include: Default, Outside First, and Inside First.

Justification

Changes the justification of the text in the Note. Settings include: left, center, and right. The effects of this setting will only be seen when there are multiple lines of Notes.

Margin Values

These values set the margin between the actual Note text and the edge of the Note box.

Top
Sets the space in pixels between the top of the text and the top edge of the text box.
Left
Sets the space in pixels between the left edge of the text and the left edge of the text box.
Bottom
Sets the space in pixels between the bottom of the text and the bottom edge of the text box.
Right
Sets the space in pixels between the right edge of the text and the right edge of the text box.

Set Word Wrapping Width To

If checked, this box specifies that the Note box should be no wider than the number of pixels indicated in the box below. If the Note box is wider than this value, it will automatically wrap and form another line inside of the Note box.

Show Border

If checked, the PopUp text box will be surrounded by a border.

Border Color
Allows you to change the color of the PopUp text box. Clicking on it brings up the Color Properties dialog (refer to "Color Properties").

Font

This button will launch a Font Properties dialog, where you can change the font of the PopUp text for the graph. For more information about this dialog, refer to "Font Properties" in Chapter A.

Leader Line Width

The width of the leader line. The leader line is the line that originates from the data item and leads to the Note box.

Leader Color

This color button allows you to set the color of the leader line. Clicking on it brings up the Color Properties dialog (refer to "Color Properties").

Month/Day Names (Time Plot)

This dialog allows you to change the names used for months and weekdays within a graph. For example, if you want your month and day names to be abbreviated, you could abbreviate them all in this dialog pane. Also, you could change these names to another language.

3D Settings (Area, Bar, Line, Pareto, Pie)

This pane controls 3D settings for the currently selected graph.

Show 3D Graph (Line Bar)

This option is available only for Line Bar graphs. If checked, the graph will appear as a three-dimensional graph. Otherwise, it will be two-dimensional. Note that this option will always make the bars three dimensional. However, Show 3D Line must be checked for the line to appear three dimensional.

Show 3D Bars / Lines / Pie / Area

If checked, the indicated feature (bar, line, pie, or area) will appear 3D, as will the background grid. However, this will have no affect on a Line Bar graph unless Show 3D Graph is enabled.

X Offset %

Changes the offset, as a percentage of the category width, of the x dimension of the bar, area, or line. The offset affects the angle from which the user appears to be looking at the graph. Values can range from 0 to 40. This setting does not apply to Pie graphs.

Y Offset %

Changes the offset, as a percentage of the category width, of the y dimension of the bar, pie, area, or line. The offset affects the angle from which the user appears to be looking at the graph. Values can range from 0 to 40.

Depth %

Changes the depth, as a percentage of the category width, of the bar, line, area, or pie. This is essentially the z dimension of the graph.

Colors

This pane controls color settings for the currently selected graph.

Series Colors

This allows you to change the color settings for the data series.

Select a Color Theme
Allows you to select from several pre-set color themes. Selecting a new color theme will override any color changes that you have already made for bars, lines, areas, or pie wedges. It will not affect background, border, or font colors.
Color themes are set in the config/PCColors.xml file. Refer to Chapter 11, "Color Themes," in the PopChart Server Reference manual for details on how to add color themes to this file.
Colors
These 16 color buttons represent the colors of the bars, lines, pie wedges, or areas within the graph. The first color corresponds to the first data series, the second to the second series, and so on. You can set colors for up to 16 data series before the graph will start reusing colors. You can change each color with the Color Properties dialog that comes up when you click on a color button (refer to "Color Properties").
To set colors for series beyond the first 16 series, change the color button for that series in the Series Properties dialog.

Grid Area Background Colors

This allows you to change the background color of the graph's grid area.

By default, the transparent box is checked, meaning that the area will have no background color. If you uncheck this box, the area will have the background color shown in the color button to the right of the check box. You can change this color with the Color Properties dialog that comes up when you click on a color button (refer to "Color Properties"). The image on the far right indicates the areas that each option changes. Note that Side and Bottom affect only 3D graphs.

Advanced

This controls advanced properties for the graph object. For more information, refer to "Advanced Object Properties".