Activex User'S Guide: First Impression
Activex User'S Guide: First Impression
TM
First Impression
High performance software for charting data
® TM TM
Version 6.0
This program is not fault-tolerant and is not designed, manufactured or intended for use or resale in the on-
line control of nuclear facilities, aircraft navigation or communication systems, air traffic control, direct life
support machines, or weapons systems in which the failure of the Program could lead directly to death,
personal injury, or severe physical or environmental damage.
Tidestone Technologies, First Impression, Formula One, and VisualSpeller are trademarks of Tidestone
Technologies, Inc.
Microsoft, MS, MS-DOS, Visual Basic, Visual C++, and Windows are registered trademarks and Microsoft
Access and Microsoft Excel are trademarks of Microsoft Corporation in the U.S. and other countries.
Java, 100% Pure Java, and all Java-based trademarks and logos are trademarks or registered trademarks of
Sun Microsystems, Inc., in the U.S. and other countries.
All other company and product names mentioned may be trademarks or registered trademarks of the
companies with which they are associated.
The Tidestone License Agreement, included with the product, specifies the permitted and prohibited uses of
the product. Any unauthorized reproduction or use of the product, or breach of the terms and conditions of
the License Agreement, is forbidden. The Tidestone License Agreement sets forth the only warranties
applicable to the product and documentation. All warranty disclaimers and exclusions set forth therein
apply to the information contained in this document.
Published by
Tidestone Technologies, Inc.
12980 Metcalf Avenue, Suite 300
Overland Park, Kansas 66213
phone 913 / 851-2200
toll-free 1-800-884-8665
fax 913 / 851-1390
www.tidestone.com
Contents
Preface Welcome To First Impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
New Features in First Impression 6.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Other Features of First Impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installing the Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
What Does The Installation Program Do? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
After Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
If You Experience Installation Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Tidestone
9
P R E F A C E
Installation
The Installer Program can be used to install both trial and working versions of any
component.
You are prompted for a valid serial number during installation. If you enter a valid
serial number, Formula One successfully installs as a working developer version.
Preface 11
The product is installed as a trial (demo) version if you do one of the following:
■ press ENTER at the serial number prompt
■ unsuccessfully attempt to enter a valid serial number three times
After the third attempt, the product installs as a trial version.
The trial version of a product is NON-REDISTRIBUTABLE component and will
expire after 15 days. You cannot deploy applications with this version. The trial
version displays the About Box every 30 minutes reminding you that you are
working with an evaluation version of the product. If you wish to continue
evaluating the product after the 15-day trial, contact Tidestone.
After Installation
Once you install the product, you can determine if you have a full version of the
product or a trial version by displaying the About Box. This can be done by
executing the AboutBox method in code. Text in the About Box tells you whether
you are using an evaluation copy.
After you successfully install a full version on your system, you can distribute that
ActiveX control to your end-users without worrying that the About Box might
display on their system every 30 minutes. If you have any concerns as to which
version you are deploying, check the About Box.
Technical Support
The Tidestone technical support staff can help you with any problem you
encounter installing or using First Impression. You can contact Tidestone in any of
the following ways:
■ On the World Wide Web. For best service, send your technical support requests
to the Tidestone Case Tracking System, accessible from the Tidestone website.
Point your browser at www.tidestone.com/support/tsmain.htm.
■ By telephone. You can contact our technical support staff at (913) 851-2200 on
weekdays between 9:00 a.m. and 4:00 p.m., central time.
■ By fax. You can contact us by fax at (913) 851-1390.
■ By mail. Address your correspondence to:
Tidestone Technical Support Department
12980 Metcalf, Suite 300
Overland Park, KS 66213
■ In Europe, contact:
Tidestone Europe
Lenexa House
11 Eldon Way
Paddock Wood, Kent
England TN12 6BE
Tel: +44 1892 834343
Fax: +44 1892 835843
Preface 13
Documentation Conventions
Throughout this documentation, typographic conventions are used to define
elements and references to First Impression items.
Recognizing these conventions will assist your comprehension of this
documentation.
Convention example Description
AxisSelected, AllowSelections, Select, Names of events, properties, and methods, are
in proper case and bold font.
➤ To install First Impression: A series of numbered instructions are
preceded by an introductory line. The
introductory line begins with an arrowhead.
1.Type a:\setup. Numbered instructions provide step-by-step
directions for performing tasks. The
instructions should be performed in the order
they are presented. In numbered steps, items
you are to enter are shown in Letter Gothic
font.
chart plot In general sections, italic text is used for the
first occurrence of a new term.
thicknessratio In reference sections, italic text indicates
variable or argument information you must
supply.
[axis_id] In reference sections, italic text surrounded by
square brackets indicates optional arguments.
{TRUE|FALSE} In reference sections, text surrounded by
braces indicates you must make a choice
among the items inside the braces. Choices are
separated by vertical bars.
VtChart1.AllowDithering Letter Gothic font is used for all code
examples.
TTFI6.OCX File names are presented in upper case text.
VtChart1.RowCount ’number of In code examples, an apostrophe precedes a
rows comment.
Tidestone
15
C H A P T E R 1
Getting Started
Basic Concepts
First Impression is a Custom Control (ActiveX control). It can be accessed directly
by Microsoft’s Visual Basic, Visual C++, and other environments that support
ActiveX control containers.
■ In design mode, randomly generated data is provided to allow you to design a
default format for the chart control. You can override this data by inserting
specific values in the data grid.
■ In run mode, data can be assigned to the data grid associated with the chart.
This data is charted using the default format you created during design time.
You can also allow additional formatting of the chart during run time.
■ The chart format can be modified from code or from the built-in user interface.
■ Charts can be saved with a form or in a separate file.
■ Any formatting changes you make to a chart using the First Impression
interface are only saved if you are in design mode. Changes made through the
interface in run mode are not saved with the chart.
ActiveX Development
This version of First Impression is designed for developers creating 32-bit ActiveX
applications in Visual Basic 5.0 or 6.0, Visual C++ 5.0 or 6.0, PowerBuilder 5.0 or
6.0, or other environments that support ActiveX containers.
First Impression provides an ActiveX control (TTFI6.OCX) for use in developing
32-bit applications.
This document shows code examples in Visual Basic because of Visual Basic’s
wide acceptance and ease of use.
7. Click the button to the right of the Database Name property and browse for the
database file.
8. Click the button to the right of the Connect property to display the list of
available database types.
9. Select the database type for which you want to connect.
10. Click the button to the right of the RecordSource property to select the table
name from your database.
The First Impression component is now bound to your database.
where Table1 is the name of the table in the database for which you want to
retrieve data.
10. Click OK to dismiss the Property Pages.
11. With the Remote Data Control still selected, press F4 to access the property
list.
Chapter 1 Getting Started 19
12. The SQL property displays the SQL command that you previously entered.
13. Click the button to the right of the Database Name property and browse for the
name of your database from the combo box.
The First Impression component is now bound to your database.
Important Visual C++ does not read constants from the ActiveX control. The file
TTFICNST.H, distributed with First Impression, should be included wherever you
use constants in your code.
Dialog-Based Applications
To create a dialog box-based application, be sure to complete the steps in
“Creating a Dialog, CFormView, or CView-Based Application” on page 19 before
continuing with the following steps:
CFormView-Based Applications
To create a CFormView-based application, be sure to complete the steps in
“Creating a Dialog, CFormView, or CView-Based Application” on page 19 before
continuing with the following steps:
CView-Based Applications
To create a CView-based application, be sure to complete the steps in “Creating a
Dialog, CFormView, or CView-Based Application” on page 19 before continuing
with the following steps:
4. Now through the file list, display the C++ source file for the view
(<projname>view.cpp).
5. Start the ClassWizard, and make sure the view class is selected as the Class
Name.
6. Select the View object in the Object Id list.
Chapter 1 Getting Started 23
7. Select the “Create” message in the Messages list. Click Add Function.
The Create handler initially presents the following code:
return CWnd::Create(lpszClassName, lpszWindowName, dwStyle, rect,
pParentWnd, nID, pContext);
8. Start the ClassWizard, and select view class as the Class Name.
9. Select the View object in the Object Id list.
10. Select the WM_SIZE message in the Messages list.
11. Click Add Function to create the OnSize handler function for this message.
12. Add the following code to the handler:
// TODO: Add your message handler code here
if (m_chart) {
m_chart.MoveWindow(0, 0, cx, cy);
}
An object’s sub-objects are accessed via a Get method, which returns a pointer to
an OLE IDispatch object. This pointer is used to construct the sub-object. For
example, the code below accesses the Plot, Axis, and AxisScale sub-objects:
VARIANT Index;
VariantInit (&Index);
Index.vt = VT_12;
Index.iVal = 1;
yvscale.SetAuto(FALSE)
yvscale.SetMinimum(-10.0);
yvscale.SetMaximum(200.0);
6. Run the program and when the document is clicked, the message “You clicked
on the document” is displayed.
Chapter 1 Getting Started 25
6. Select the Remote Data Control from the palette, and draw it on your form.
7. Right-click the Remote Data Control and select Properties.
The Properties dialog box appears.
8. Select the Control tab.
9. Click the combo box to display and select the DataSource (e.g. the DataSource
name set up during the ODBC Setup process).
10. Type the following command in the SQL text box:
Select * from tablename
Database Preparation
Prior to creating an application in PowerBuilder which accesses a database, you
must ensure that you have correctly configured your environment. The following
steps outline some preliminary measures to take before working with databases in
PowerBuilder.
General Information
The following section describes general information about using First Impression
with PowerBuilder.
Method Example:
Ole_1.object.SetSelection (1,1,5,5)
3. In each FRM file for a project containing an MSChart control, locate the
following line of code:
Object = "{02B5E320-7292-11CF-93D5-0020AF99504A}#1.0#0";
"MSCHART.OCX"
5. For each MSChart control on each form, locate the code in the FRM file that
looks like the following:
Begin MSChartLib.MSChart SomeName
7. Load the project as usual. If the conversion was successful, load errors for the
chart do not occur, and the MSChart controls on each form are replaced with
full-featured VtChart controls.
8. If you followed the previous steps, and the load fails and leaves a LOG file
similar to the following:
Line 21: Class VtChartLib.VtChart of control SomeName was not a
loaded control class.
Line 24: The property name OleObjectBlob in SomeName is invalid.
...then you forgot or incorrectly implemented steps five and six for one or more
of your controls.
41
C H A P T E R 2
100 100
90 90
Data point
80 80
70 70
Data points in the
60 60 same series
50 50
40 40
30 30
1992 1993 This chart has two
Years Covered in Study categories: 1992
and 1993
42 First Impression ActiveX User’s Guide
Charts can also have titles, backdrops, legends, plots, and footnotes. The following
illustration identifies these common chart elements in their default positions.
Chart title
Chart backdrop
Legend
Plot
Footnote
25 Tick mark
20
15 Y axis labels
10
X axis labels
Y axis title
Chapter 2 Understanding Chart Basics 43
Datapoint labels
Datapoint
Wall
Base
Chart Types
This section describes each chart type supported by First Impression. The
illustrations and general information about the various 2D and 3D chart types
might help you determine which chart type best suits your data.
Area Charts
Use area charts to emphasize the relative importance of values over a period of
time. An area chart focuses on the magnitude of change rather than the rate of
change.
Each filled area on the chart represents a series and is identified by a different
color or pattern. Values are plotted on the vertical (Y) axis and categories are
plotted on the horizontal (X) axis. You can also chart one or more series against
the secondary Y axis instead of the primary axis if you want to compare different
but related things on the same chart..
90
80
70
60
50
40
30
20
10
0
’70 ’72 ’74 ’76 ’78 ’80 ’82 ’84 ’86 ’88 ’90 ’92
2D area chart
3D area chart
Chapter 2 Understanding Chart Basics 45
Bar Charts
Use bar charts to compare one item to another, or to compare a number of items
over a period of time. These charts are particularly effective at showing large
changes from one category to another.
Each 2D or 3D bar represents a value in the data grid. Bars representing a series
are located at the same position in each category and have the same color and
pattern.
90 90
80 80
70 70
60 60
50 50
40 40
30 30
20 20
10 10
0 0
January February March
2D bar chart
3D bar chart
In 2D bar charts, values are grouped on the vertical (Y) axis, and bars are grouped
by category along the horizontal (X) axis. On 3D bar charts, values are plotted on
the vertical (Y) axis, categories are grouped along the horizontal (X) axis, and the
depth (Z) axis shows series.
Horizontal Bars
Horizontal bars are similar to standard bar charts except that the categories are
organized on a vertical (X) axis and the values are plotted on a horizontal (Y) axis.
January
February
March
0 10 20 30 40 50 60 70 80 90
Clustered Bars
Series and data points in a clustered bar chart are displayed as they are in a 2D bar
chart; however, the chart and all the chart elements are displayed in 3D.
Line Charts
Use line charts to show trends or changes in data over a period of time. These
charts emphasize time flow and rate of change rather than amount of change.
100 100
90 90
80 80
70 70
60 60
50 50
40 40
30 30
20 20
10 10
0 0
Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
2D line chart
3D line chart
In 2D line charts, values are plotted along the vertical (Y) axis and categories are
displayed on the horizontal (X) axis. In 3D charts, values are plotted on the
vertical (Y) axis, categories are grouped along the horizontal (X) axis, and the
depth (Z) axis shows series.
Chapter 2 Understanding Chart Basics 47
Step Charts
Use step charts to compare items that do not show trends. Step charts display
distinct points along the value (Y) axis, with vertical lines showing the difference
between each point. The horizontal (X) axis shows categories.
Combination Charts
Use combination charts to visually highlight the differences between multiple
series of data. A different method can be used to draw each data series.
2D combo chart
3D combo chart
48 First Impression ActiveX User’s Guide
Radar Charts
Use radar charts to show changes or frequencies of each series relative to a center
point and to one another. Lines connect all the data markers in the same series.
You can choose to fill the lines, thereby creating a radar area chart.
Perf.
10
Perf.
10
8
8
6
6
4
4
Service 2 Price
Service 2 Price
Ease Ease
XY Charts
Use XY charts to plot two groups of numbers as one series of XY coordinates.
Each series on the chart requires two columns of data in the data grid. The first
column holds the X coordinate and the second column the Y coordinate. The
column label on the first column in each series is used to identify the series in the
legend. Additionally, any formatting applied to the first column is used to display
the series on the chart. Any formatting applied to the second column is ignored.
You can use markers or lines or both to draw the XY points.
XY line chart
XY marker chart
50 First Impression ActiveX User’s Guide
Polar Charts
Use polar charts to show cyclical trends.
The polar chart requires two columns in the data grid for each chart series: the first
column holds the distance from the center of the chart (the radius), and the second
column contains the angle on the perimeter of the chart. The column label on the
first column in each series identifies the series in the legend. Additionally, any
formatting applied to the first column is used to display the series on the chart.
Any formatting applied to the second column is ignored.
Polar chart
Chapter 2 Understanding Chart Basics 51
Bubble Charts
Use bubble charts to show a visual comparison using three coordinates.
Each bubble requires three columns of data in the data grid. The first column holds
the X coordinate, the second the Y coordinate, and the third the bubble size. All
the coordinates in a bubble chart measure values; therefore, the vertical (Y) axis
and the horizontal (X) axis both show values.
The column label on the first column in each series identifies the series in the
legend. Additionally, any formatting applied to the first column is used to display
the series on the chart. Any formatting applied to the second and third columns is
ignored.
Bubble chart
52 First Impression ActiveX User’s Guide
Hi-Lo Charts
Hi-lo charts are most commonly used to show stock market information. However,
these chart types can also be used for scientific data such as indicating changes in
readings over a period of time. The vertical (Y) axis shows values and the
horizontal (X) axis shows categories or dates.
First Impression supports three variations of the basic hi-lo charts. They are: hi-lo-
close, with the close marker crossing the data point or extending to the right of the
data point; open-hi-lo-close; and open-hi-lo-close bar.
The data in the data grid must be organized appropriately for each variation of the
hi-lo chart.
■ A hi-lo chart requires two columns of data: the first column is used for the high
point and the second is used for the low point.
■ A hi-lo-close chart requires three columns of data: the first column is used for
the high point, the second for the low point, and the third for the closing point.
■ An open-hi-lo-close or a open-hi-lo-close bar chart (sometimes called candle
stick charts) requires four columns of data: the first column is used for the open
point, the second for the high point, the third for the low point, and the fourth
for the closing point.
The column label on the first column in each series identifies the series in the
legend. Additionally, any formatting applied to the first series is used to display
the series on the chart. Any formatting applied to the remaining series is ignored.
Chapter 2 Understanding Chart Basics 53
Gantt Charts
Use Gantt charts to display a range of bars that indicate the relative time required
for various activities within a project. The horizontal axis (Y) shows dates and the
vertical axis (x) shows categories.
This chart type requires two columns of data. The first column holds the start date,
and the second column holds the duration.
2D Gantt chart
3D Gantt chart
Elevation Charts
Elevation charts are commonly used to display topographic data. There are two
types of elevation charts: contour charts and 3D surface charts.
Elevation charts do not have series data. The data grid requires at least two
columns and two rows of data in order to draw a surface or contour chart. If the
data grid is missing data, a value of zero is supplied.
A contour chart is drawn as a two-dimensional area. Changes in the data plotted on
this chart are demonstrated through variations in color known as contours.
Contours are drawn on the chart as either colored bands or lines. Contour bands
can be represented on the chart in dramatic contrast or as a subtle transition in hue
known as gradient. Contour charts do not have a value axis; the variation in color
is represented in the legend instead.
A surface chart is drawn as a rectangular grid with a surface base or floor. The
value axis is drawn perpendicular to the chart base, giving the chart its three-
dimensional quality. Data variations are plotted on this chart at raised elevations
from the surface. The data points themselves are plotted on grid intersections at
the corresponding value axis elevation, thus giving the chart depth.
54 First Impression ActiveX User’s Guide
2D contour chart
3D surface chart
Chapter 2 Understanding Chart Basics 55
3D XYZ Charts
This chart shows variation and relationships over three sets of values plotted on a
three-dimensional grid. Each data point represents the intersection of the X,Y and
Z axes.
Each series on the chart requires three columns of data in the data grid. The first
column holds the X coordinates, the second column holds the Y coordinates and
the third column holds the Z coordinates.
3D XYZ chart
3D Scatter Charts
This chart is drawn as a three-dimensional grid with a base and walls. It plots data
points created by the intersection of three different coordinate values.
Each of the three values that make up a point corresponds to a particular axis in a
3D grid. Each series on the chart requires three columns of data in the data grid.
The first column holds the X coordinates, the second column holds the Y
coordinates and the third column holds the Z coordinates.
C1
C4
3D Scatter chart
56 First Impression ActiveX User’s Guide
The following table includes a description of each menu item on the context menu.
Item Description
Cut Cuts the current chart and places a copy of it on the clipboard in
Windows Metafile (.wmf) format.
Copy Places a copy of the current chart on the clipboard in Windows
Metafile (.wmf) format.
Paste Takes a graphic in Windows Bitmap (.bmp), Windows Metafile
(.wmf) format, or Joint Photographic Experts Group format (.jpg)
from the clipboard and places it in the selected element’s backdrop
or fill.
Delete Removes the current chart.
Bring to Front Places the selected objects in front of other objects.
Send to Back Places the selected objects behind other objects.
View Code Allows you to view the code for the selected object.
Chapter 2 Understanding Chart Basics 57
Item Description
Align to Grid Aligns the top left of the selected objects on your form to the
closest grid. The objects are not resized.
Properties Displays Property Pages that allow you to format your chart.
Edit Accesses edit mode.
Chart Designer Displays the Chart Designer.
Edit Chart Data Modifies the data, rows, columns, and labels in the data grid.
Wizard Guides you through the chart design process.
Print Displays the Print dialog box.
Save As Saves the current file as a chart file (.vtc), a bitmap (.bmp), a
metafile (.wmf), or a Joint Photographic Experts Group (.jpg) file.
Open Loads an existing chart file into the current chart control. The chart
you load replaces the chart already in the control.
Changing Properties
Once a chart is placed in the container, you can access the property pages through
the context menu if the ActiveX container supports it. Not all the containers
behave in the same manner. In Visual Basic, you access the context menu by right-
clicking the chart control.
You can format chart attributes using property pages in a similar manner as in the
Chart Designer. Refer to the chapters throughout this book to learn more about
formatting chart attributes.
60 First Impression ActiveX User’s Guide
The Chart Designer provides a tree view Click this button to reset any chart
that allows you to interactively design a modifications back to the default
chart. settings.
2. When your changes are complete, click OK or Apply to redraw the chart to
reflect the changes.
Chapter 2 Understanding Chart Basics 61
You can also quickly edit individual chart elements if you access the Chart
Designer from edit mode. For example, if you want to edit the value scale of the Y
Axis on a chart, you could display the Chart Designer with the Y Axis already
highlighted in the Chart Designer tree view, and the current settings displayed in
the Value Scale tab.
Use the following procedure to quickly edit chart elements.
Select Chart
to display the
Type tab.
Select Plot to
make design
choices for the
chart.
Selecting Axes
In the Chart Designer tree view you can select a specific axis for a chart or you can
select all the axes and set common attributes from the available tabs. Once the axis
titles are selected, you can make design choices from the available tabs.
Note Not all the chart types contain all the axes. For example, 2D charts do not
have a Z axis. In addition, depending on the type of data in your chart, your axis
might be one of three possible scale types: Category, Value, or Date scale. For
more information about the kind of axes your chart contains, see Chapter 8,
“Formatting Axes.”
Hold down
the CTRL key
and select X
Axis, Y Axis,
Second Y
Axis, and Z
Axis to
display the
common tabs
for these
chart
elements.
64 First Impression ActiveX User’s Guide
Note The Axis Title Object in the First Impression API has a Visible Property that
is not exposed in the Chart Designer. In order to actually place axis titles on your
chart, you must edit or modify the default axis title text that exists in the Text tab,
then click the Apply button.
Hold down
the CTRL
key and
select Axis
Title to
display the
common
tabs for
these chart
elements.
Chapter 2 Understanding Chart Basics 65
Note Not all the chart types contain all the axes. For example, 2D charts do not
have a Z axis. In addition, depending on the type of data in your chart, your axis
might be one of three possible scale types: Category, Value, or Date scale.
Category axes have text labels identifying the category or series in the chart. Value
axes display numbers as values or percents. Date/time axes display a range of
dates and/or times. For more information about the kind of axes your chart
contains, see Chapter 8, “Formatting Axes.”
Hold down
the CTRL
key and
select Axis
Labels to
display the
common
tabs for
these chart
elements.
66 First Impression ActiveX User’s Guide
Specific
default data
point label
Specific data
point label
To select
multiple
series labels,
hold down the
CTRL key and
select the
series labels.
C H A P T E R 3
Managing Charts
This chapter provides information about managing your charts. For example, it
covers:
■ Manually repositioning and resizing chart elements.
■ Exporting charts.
■ Loading saved charts.
■ Deleting charts.
■ Setting print options and print setup.
■ Linking to a Formula One spreadsheet.
The following illustration shows the results of resizing and repositioning chart
elements.
The custom chart was given more impact by enlarging the plot and repositioning it higher in the chart.
The border was also removed from the legend and it was repositioned slightly to better fit with the
resized plot.
Note To reposition or resize a chart element using the Chart Designer, select the
Custom Location radio button in the Location tab for the chart element that you
want to modify.
Exporting Charts
There are two ways to export copies of a chart or chart element from First
Impression: by copying it to the clipboard, or by saving it to a file.
You can save the chart in the native First Impression format (.vtc), as a standard
metafile (.wmf), as a Windows bitmap (.bmp), or as a Joint Photographic
Experts Group (.jpg) file. By default, the Adobe placeable header information
is included in the metafile.
4. To save the metafile without the Adobe Placeable header information, check
Save metafile without size information.
Do not check this option if you intend to use this metafile in a Microsoft
application such as Word or Excel. These applications expect size information
to be included in metafiles.
5. To save the text on the chart as curves check Save Text As Curves.
You should check this option if you are using an unusual font that might not be
present on other systems using the metafile. This option should also be used to
properly display text if you are deforming the metafile by stretching it.
6. Click Save.
➤ To load a file:
1. Use the right mouse button to display the context menu and choose Open.
The Open dialog box appears. A list of all the .vtc files in the current directory
is displayed.
2. Select the file you want to open.
3. Click OK.
Deleting Charts
You can delete a chart using First Impression’s context menu. However, you
cannot delete individual chart elements.
➤ To delete a chart:
1. Click the chart using the right mouse button.
2. Choose Delete from the resulting context menu.
The chart is removed.
72 First Impression ActiveX User’s Guide
Printing Charts
You can print a copy of the current chart. You can also set print and page layout
settings.
➤ To print a chart:
1. Use the right mouse button to display the context menu and choose Print to
display the Print dialog box.
2. Make any necessary settings and click Print.
Specific information about the settings that you can access from the Print dialog
box is presented in the following discussion.
The following illustration shows a form containing a First Impression chart control
and a Formula One spreadsheet control. To view the code behind this form, refer
to the Formula One Link demo that is shipped with First Impression.
Notice that the data in the spreadsheet control must be organized in a manner that
the chart’s data grid can understand. In the case of the previous illustration, the
first row of labels are used to identify each series in the legend. The first column
of labels are used to identify each pie. Each column of data in the spreadsheet
represents a different slice of the pie.
For additional information, run the data grid demo supplied with First Impression.
This demo shows the minimum amount of data required for each chart type and
shows how that data should be organized.
Note AutoParse mode can be very useful when linking to simple ranges of data
that are organized in exactly the way First Impression expects to find the data.
However, using On mode and setting the data grid dimensions yourself is
recommended in most cases that involve more complex data or unusual data
arrangements. For example, if your data does not contain column labels,
AutoParse may become confused and you may not get the chart you expect.
77
C H A P T E R 4
Data grids hold text for series and category labels and charted values on charts. A
data grid is comparable to an array or table containing chart information.
Series Labels
In most cases, each column in the data grid translates to one series on the chart.
However, First Impression supports a number of chart types that require two or
more columns of data to chart a series. These chart types include XY, polar,
bubble, hi-lo, and Gantt charts. Specific information about the data grid
requirements of these chart types is included in the following discussion.
Note You might format a chart in an application designed for you by someone else.
To use one of the chart types that requires more than one column of data for a
series, you might need to have that person familiarize you with the structure of the
chart data.
Since the data grid is initially filled with random data, you can start by resizing the
data grid to agree with the size of the worksheet containing your data. To resize
the grid, indicate the correct number of rows and columns for your worksheet in
the Data Grid Editor. You can also specify the number of levels of labels for the
rows and columns.
Chapter 4 Understanding Data Grids 79
➤ To resize the data grid for eight rows and columns of data:
1. Double-click the mouse cursor in the Rows text box of the Data Grid Editor to
select the current row value.
2. Type the number 8.
3. Tab to the Columns text box and type the number 8.
4. Tab to exit the Columns text box.
5. Click the Apply button.
The data grid displays eight columns and eight rows. The additional column and
row cells appear empty. Once you have resized the data grid to accommodate your
worksheet data, you can modify the grid data.
The Add Row, Add The Add Row, Add Row The Add Column, Add Column
Column, Delete Row, Label, Delete Row, and Label, Delete Column, and
and Delete Column Delete Row Label menu Delete Column Label menu
menu items display items display when you items display when you right-
when you right-click a right-click a data grid row click a data grid column label.
data grid cell. label.
Chapter 4 Understanding Data Grids 81
Important Inserting and deleting column and row labels always affects the entire
row or column of labels. A single label cannot be inserted or deleted.
84 First Impression ActiveX User’s Guide
In general, data grid columns are represented as series on a chart, and data grid
rows are represented as data points within a chart series. However, in First
Impression, you can specify if you want data grid rows to contain chart series
data.
The organization of information in the data grid varies for each chart type. Specific
information about how the data grid should be organized for different chart types
is presented at the end of this chapter. The following illustration shows a 3D bar
chart based on this simple data grid.
Series Labels
Series Labels
Assembled Unassembled
Model 421 Model 532 Model 629 Model 421 Model 532 Model 629
1993 East 29 60 88 40 52 62
Category Labels
Central 79 49 95 66 29 37
West 64 35 57 88 44 77
1994 East 4 40 62 25 55 59
Central 22 18 62 18 12 44
West 40 10 39 54 9 51
Chapter 4 Understanding Data Grids 87
Assembled Unassembled
Model 421 Model 532 Model 629 Model 421 Model 532 Model 629
1993 East 29 60 88 40 52 62 Row 1
Central 79 49 95 66 29 37 Row 2
West 64 35 57 88 44 77 Row 3
1994 East 4 40 62 25 55 59 Row 4
Central 22 18 62 18 12 44 Row 5
West 40 10 39 54 9 51 Row 6
Column 1 Column 2 Column 3 Column 4 Column 5 Column 6
Note For information about identifying columns in data grids used to draw more
complex chart types, refer to the section titled “Data Grids for Special Chart
Types” on page 95.
Column labels identify the data columns. They are numbered from left to right
within each level. Multiple levels of column labels are numbered from bottom to
top, beginning with 1. Row labels identify the data rows. They are numbered from
top to bottom, beginning with 1. Multiple levels of row labels are numbered from
right to left beginning with 1.
West Label 3
Level 2 Level 1
Row Labels
88 First Impression ActiveX User’s Guide
In order to properly match lower and higher level labels, First Impression analyses
the text in a label and compares it to the text in the next label. If the text is the
same, or a null string, First Impression assumes the lower level label is still
associated with the same higher level label. It continues associating lower level
labels as long as it encounters the same text or a null string.
Chapter 4 Understanding Data Grids 89
When it encounters a new string, it stops associating lower level labels with the old
string and begins associating them with the new string. The following illustration
shows an example of this process.
1993 null string null string null string 1994 null string
Q1 Q2 Q3 Q4 Q1 Q2
US Eastern Region 29 60 88 40 52 62
null string Central Region 79 49 95 66 29 37
null string Western Region 64 35 57 88 44 77
Europe Northern Region 4 40 62 25 55 59
null string Southern Region 22 18 62 18 12 44
These null strings tell First Impression that Once First Impression encounters the string 1994,
the labels Q2, Q3, and Q4 are associated it stops associating 1993 with columns and begins
with 1993. associating 1994 with any null strings it finds until
the next string is encountered.
Important When comparing the contents of each column label, First Impression
differentiates between null strings and a string of spaces. If it encounters a string
of spaces, it assumes it is a new label. Information on how to ensure a column
label contains a null string is provided in “Manipulating the Data Grid Using
Properties” on page 90.
Important In most chart types, each column in the data grid represents a series on
the chart. However, First Impression supports a number of special chart types that
require two or more columns to chart a series. Specific information about the data
grid requirements of these special chart types is provided in “Data Grids for
Special Chart Types” on page 95.
Chapter 4 Understanding Data Grids 91
Note If you are removing an existing label from a column or row, highlight it in the
Properties Window and press Delete. This tells First Impression to place a null
string in the label. If you remove the existing label by highlighting it and pressing
the space bar, you are actually replacing the label with spaces instead of a null
string.
■ Use the Data property to modify an individual value in the data grid. Use
Column and Row properties to identify the data you wish to change before
using the Data property which assigns the new data value. If you assign a value
with the Data property, the RandomFill property is automatically set to
FALSE to prevent you from losing the data you entered.
■ Use RandomFill to generate random data for prototyping a chart.
■ Use the SetSize method to change all the dimensions of the data grid at once.
You can use this function to set the column count, row count, column label
count, and row label count in one operation. This saves you from having to use
four separate functions to set each parameter individually.
Note Both DeleteColumns and DeleteRows delete cells and their labels.
92 First Impression ActiveX User’s Guide
Important When new labels are added to the data grid, either by adding a new level
of labels or adding rows or columns to the data grid, they contain a null string.
When new columns or rows of data are added, their status depends on the current
setting of the RandomFill property. If RandomFill is set to False, the columns
and rows contain a null value. If RandomFill is set to True, the columns and rows
are filled with random data.
To turn on the display of guidelines in this series, refer to To change the value in this position in the data grid,
series three in the following code refer to row 2, column 4 in the following code.
Vtchart1.plot.seriescollection.item(3).showguideline With VtChart1
(vtchaxisidx) = True column = 4
row = 2
data = 58
end with
For some chart types, data must be organized in a specific way in the data grid in
order for the chart to display correctly. See the sections below for information
about each special chart type.
96 First Impression ActiveX User’s Guide
XY Charts
An XY chart plots two pairs of numbers as x and y coordinates. Each series on the
chart requires two columns of data in the data grid. The first column holds the x
coordinate and the second column the y coordinate. The partial data grid in the
following illustration shows the organization required for an XY chart.
XY Line Chart
Polar Charts
Polar charts require two columns in the data grid for each chart series: the first
data column holds the distance from the center of the chart (the Radius) and the
second column holds the angle from the zero (0) position of the chart (the Angle.)
The column label on the first column in each series is used to identify the series in
the legend. Additionally, any formatting applied to the first column is used to
display the series on the chart. Any formatting applied to the second column is
ignored. The partial data grid in the following illustration shows the organization
required for a polar chart.
Polar Chart
(Angle)
Rose Radius
.39207 2.8125
.078036 5.625
1.16114 8.4315
1.53073 11.25
98 First Impression ActiveX User’s Guide
Bubble Charts
Each series displayed on a bubble chart requires three columns of data in the data
grid. The first column holds the X coordinate, the second column holds the Y
coordinate, and the third column determines the relative bubble size. The column
label on the first column in each series is used to identify the series in the legend.
Additionally, any formatting applied to the first column is used to display the
series on the chart. Any formatting applied to the second and third columns are
ignored.
Hi-Lo Charts
The data in the data grid must be organized appropriately for each type of hi-lo
chart supported by first impression.
Hi-lo charts require two columns for each data series: the first column is used for
the high point, and the second is used for the low point.
(High)
Stocks R Us Low
Jan 3 10 8
Jan 4 11 9
Jan 5 12 10
Jan 6 13 11
Jan 7 14 12
Jan 10 15 13
Jan 11 16 14
Jan 12 17 15
Jan 13 18 16
Hi-Lo Chart
Jan 14 19 17
Hi-lo-close charts require three columns for each data series: the first column is
used for the high point, the second for the low point, and the third for the closing
point.
(High)
Stocks R Us Low Close
Jan 3 10 8 9
Jan 4 11 9 10
Jan 5 12 10 11
Jan 6 13 11 12
Jan 7 14 12 13
Jan 10 15 13 14
Jan 11 16 14 15
Jan 12 17 15 16
Hi-Lo-Close Chart Jan 13 18 16 17
Jan 14 19 17 18
100 First Impression ActiveX User’s Guide
Open-hi-lo-close charts require four columns for each data series: the first column
is used for the open point, the second for the high point, the third for the low point,
and the fourth for the closing point.
(Open)
Stocks R Us High Low Close
Jan 3 10 11 8 9
Jan 4 11 12 9 10
Jan 5 12 13 10 11
Jan 6 13 14 11 12
Open Hi-Lo-Close Bar Chart Jan 7 14 15 12 13
Jan 10 15 16 13 14
Jan 11 16 17 14 15
Jan 12 17 18 15 16
Jan 13 18 19 16 17
Jan 14 19 20 17 18
Hi-lo charts with date/time axes require one column that contains date information.
(These are also called charts with computed date/time axes.)
For information about creating this type of chart, see “Formatting Charts with
Computed Date/Time Axes” on page 208.
For information about entering the date and time information in this type of chart,
see “Data Grids for Charts With Computed Date/Time Axes” on page 104.
Chapter 4 Understanding Data Grids 101
Gantt Charts
Use a Gantt chart to display range bars that indicate the relative time required for
various activities within a project. This chart type requires two columns of data.
The first column is the start time and the second column is the duration, in number
of days. The column label on the first column is used to identify the series in the
legend. Additionally, any formatting applied to the first column is used to display
the series on the chart. Any formatting applied to the second column is ignored.
First Impression requires you to enter the starting dates in a special format. For
information on how to enter the start dates, see “Data Grids for Charts With
Computed Date/Time Axes” on page 104.
If this chart is linked to a Formula One worksheet, you can enter the dates in the
worksheet in a normal date format, such as 1-23-93. The worksheet automatically
stores that date as the number of days since January 1, 1900.
Also, when entering the duration in a Formula One worksheet linked to your Gantt
chart, you can use an expression to subtract a start date from a finish date to
determine the duration.
102 First Impression ActiveX User’s Guide
Elevation Charts
Use elevation charts to display topographic data. There are two types of elevation
charts: 2D contour charts and 3D surface charts. In contour charts, data values
within a specific range appear on the chart in two-dimensional bands of the same
color. In surface charts, data values within a specific range have the same
elevation. Data values can also be illustrated with contour bands or lines of the
same color projected on the three-dimensional surface model.
10 20 30 40 50 60 70 80
legend
3D Surface Chart
The contour chart and the surface chart
both illustrate how the values from the 50
data grid can be plotted as sixteen
points on the chart.
Chapter 4 Understanding Data Grids 103
3D XYZ Charts
This chart displays variation and relationships over three sets of values plotted on
a three-dimensional grid. Each series on the chart requires three columns of data in
the data grid.
Triangle Series Star Series
X Y Z X Y Z
45 15 48 50 77 55
47 93 58 53 41 60
75 31 83 55 85 63
80 47 88 75 15 88
Value
Axis (Y) 81 57 89 80 14 89
90 58 90 40 58 90
Value
Axis (Z)
Value
Axis (X)
3D Scatter Charts
This chart is drawn as a three-dimensional grid with a base and walls. It plots data
points created by the intersection of three different coordinate values. Each series
on the chart requires three columns of data in the data grid.
15 60 20 0 23 18
2 78 50 20 61 83
Value
18 33 80 30 2 81
Axis (Y)
20 52 100 22 61 82
20 69 89 30 67 100
22 49 81 68 1 65
45 47 92 60 58 90
Value
50 88 95 98 65 97
Axis (Z)
Value
Axis (X)
104 First Impression ActiveX User’s Guide
For dates, First Impression considers the integer portion of the number as the
number of days since January 1, 1900. For example, to indicate July 4, 1995, enter
34884.
For times, First Impression considers the numbers behind the decimal point as the
fraction of a 24-hour day. This decimal fraction can range from .0, representing
12:00 a.m., to 0.99999999, representing 11:59:59 p.m. To indicate 12:00 noon,
enter .5. To indicate 6:00 p.m., enter .75.
Note If your chart is linked to a Formula One worksheet, First Impression will
automatically convert the date and time information from the spreadsheet to the
numeric format described above.
For more information about charts with computed date/time axes, see “Formatting
Charts with Computed Date/Time Axes” on page 208.
105
C H A P T E R 5
The Chart Wizard is the first step in getting started with First Impression chart
design. The Chart Wizard visually guides you through the process of creating a
new First Impression chart or modifying an existing chart for use with your
application. With the Chart Wizard, you can quickly accomplish many design
tasks without directly setting a property or writing code. You point-and-click
visual cues to design the chart you desire. Once you have created a basic chart,
you can make further modifications by setting properties in code, or using the
Chart Designer.
2D Charts 3D Charts
Chapter 5 Using the Chart Wizard 107
Series Labels
Series Stacking
Bar Gap
108 First Impression ActiveX User’s Guide
C H A P T E R 6
Once you select a chart type, the chart can include a title, a legend, a plot area, and
a footnote. This chapter includes the following topics that describe how to:
■ Select a chart type.
■ Specify a backdrop.
■ Specify a picture backdrop.
■ Add and position chart elements.
■ Format and specify text.
■ Specify text alignment and orientation.
■ Specify text.
■ Format fonts.
Note The Location tab controls whether titles, legends, or footnotes are visible on
charts. For more information about the Location tab, refer to “Adding and
Positioning Chart Elements” on page 123.
112 First Impression ActiveX User’s Guide
Select the 2D radio button to Check the Data in Rows check box
display a list of the 2D chart to read series data from data grid
types in the Chart Type list. rows rather than columns.
Select the 3D radio button to
display the 3D chart types.
Specifying a Backdrop
The Backdrop tab of the Chart Designer controls the display of the backdrop. You
can enhance a chart’s appearance by placing a backdrop on the chart, and on
individual chart elements. A backdrop can include a frame or box around the chart
or chart element, a shadow behind the element, and a pattern or gradient behind
the element. The Backdrop tab applies to charts, axis titles, data point labels,
footnotes, labels, legends, plots, and series labels.
Note If you select a default data point label, these options apply to all the non-
custom data point labels. If you select a specific data point label, these options
apply to only that data point label and override default data point label settings.
The following illustration shows the various chart elements that can be assigned a
backdrop.
The data point labels have no fill, a A backdrop fill is not specified for A backdrop is not specified for the
single line frame and no shadow. the X Axis labels. plot area.
114 First Impression ActiveX User’s Guide
3. When your changes are complete, click OK or Apply to redraw the chart to
reflect the modifications.
Specific information about backdrop fills, backdrop frames, and backdrop shadows
is provided in the following sections.
Chapter 6 Formatting Common Chart Elements 115
40
35
30
25
20
15
10
Note You can specify that the chart control or chart elements have no fill. For
example, any formatting applied to the surface behind them shows through. To
specify this, select the No Fill radio button. A picture can still be applied to an
element without a fill. Refer to “Specifying a Picture Backdrop” on page 120 to
learn more about using pictures as backdrops.
Patterns are bitmaps. A low resolution version of each bitmap displays the
pattern on the screen. When you print a chart, a high resolution version of the
bitmap is used if the output device prints at more than 144 dpi. The higher the
resolution of the output device, the smaller the copies of the bitmaps that make
up the patterns are reproduced.
At high resolutions, First Impression adjusts the patterns to prevent the lines
from getting too close together. Hatches are not bitmaps, but actual lines drawn
to fill the object. They always appear the same regardless of the output
resolution. Hatches can be used to output First Impression charts on a plotter.
The following illustration shows which patterns in the Pattern list are bitmaps
and which are hatches.
Bitmapped patterns
Hatched patterns
5. In the Fill/From Color list, select a predefined color or click Custom to create
your own color. The fill color is used to create a solid pattern.
6. In the Pattern/To Color list, select a color or click Custom to create your own
color. The pattern color is drawn on top of the fill color.
7. Click OK or Apply to redraw the chart to reflect the changes.
5. Select the color used as the top color in a horizontal gradient, the left color in a
vertical gradient, and the center color in a rectangle or oval gradient from the
Fill/From color list.
6. Select the color used as the bottom color in a horizontal gradient, the right
color in a vertical gradient, and the outer color in a rectangle or oval gradient
from the Pattern/To Color list.
7. Click OK or Apply to redraw the chart to reflect the changes.
➤ To create a frame:
1. In the Chart Designer tree view, select the chart element for which you want to
edit the backdrop.
2. Select the Backdrop tab.
118 First Impression ActiveX User’s Guide
3. Select a frame style from the Style list in the Backdrop tab. The following
illustrations show the various types of frames around the plot area of the chart.
Double Line
4. Select a color for the frame lines from the Color list.
5. Enter the number of points to be used as the width for the frame lines in the
Width text box. A point is 1/72 of an inch. For the Thick Inner and Thick Outer
frames, the width sets the thick line.
6. Click OK or Apply to redraw the chart to reflect the changes.
➤ To specify a shadow:
1. In the Chart Designer tree view, select the chart element for which you want to
edit the backdrop.
2. Select the Backdrop tab.
3. Select Drop from the Shadow list in the Backdrop tab.
4. In the Offset text box, enter the number of points the shadow is offset from the
frame.
5. Click OK or Apply to redraw the chart to reflect the changes.
120 First Impression ActiveX User’s Guide
Note Although the VtPicture object can be used to display many chart types, any
chart part that is rendered in 3D perspective does not support pictures. This
includes 3D bars, 3D axis label backdrops, 3D axis title backdrops, 3D data point
label backdrops, and 3D markers. Backdrops for charts, plots, titles, footnotes, and
legends on 3D charts can support pictures because these chart parts are not
rendered in 3D perspective. Refer to the First Impression on-line Help for more
information about the VtPicture object.
The following further describes the options available in the Picture tab:
■ Picture. This setting displays a preview of the graphic. When you enter a valid
path and file name in the File text box, or paste a graphic from the clipboard,
the picture is previewed in the Picture control.
Note If you use a Windows metafile for the graphic, it does not show up if you use
the copy command to copy the chart to the clipboard. Windows limits you from
having a metafile that contains a metafile. If you plan to copy the chart to the
clipboard, use a bitmap for the graphic instead of a metafile.
Some graphics products output bitmap files in an older format that is compatible
with OS/2. First Impression does not support these bitmaps. If you attempt to use
one of these files, you receive an error, “Invalid picture format.” You can read
these files into PaintBrush and save them as BMPs to convert them to the newer
bitmap format. First Impression can then use these files without any problems.
Chapter 6 Formatting Common Chart Elements 121
■ Picture Size. These setting provide various methods to fit the graphic into the
backdrop space. The following illustrations show each of the options:
30
25
20
15
10
0
’72 ’74 ’76 ’78 ’80 ’82 ’84 ’86 ’88 ’90 ’92
30
25 25
20
20
15
10
15
5
0
10 ’72 ’74 ’76 ’78 ’80 ’82 ’84 ’86 ’88 ’90 ’92
0
’72 ’74 ’76 ’78 ’80 ’82 ’84 ’86 ’88 ’90 ’92
30
25
20
15
10
0
’72 ’74 ’76 ’78 ’80 ’82 ’84 ’86 ’88 ’90 ’92
Tiled
122 First Impression ActiveX User’s Guide
To save the picture file with the chart, check the Embed Picture check box. To save space,
you should not embed pictures unless they are not going to be available later.
3. Enter a valid path and file name in the File text box, or click the Browse button
to select a file name from the Open Picture dialog box. To paste a .wmf, .bmp,
or .jpg file from the clipboard into the current backdrop, click the Paste button.
The picture is previewed in the Picture control.
Note You can also paste a graphic into an existing backdrop by selecting the
backdrop on the screen and selecting the Paste command from the context menu.
Select the graphic file you want to paste into the backdrop and click OK.
4. Select the appropriate radio button to select a fit method from the Picture Size
section. These options allow you to fit the graphic into the backdrop space. The
following table lists the options for fitting graphics:
Constant Description
Actual Size Displays the graphic at the original size it was created. If the original size of
the graphic is too large to display in the backdrop, the graphic is cropped. If
the original size of the graphic is too small to fill the backdrop, it is
centered in the backdrop.
Best Fit Scales the graphic proportionally to fit entirely within the backdrop.
Stretch to Fit Scales the graphic to fit backdrop regardless of its original proportions.
Tiled Duplicates the graphic repeatedly to fill the backdrop.
Crop Fitted Centers the graphic and scales it proportionally to fill the backdrop. Any
part of the image that falls outside the backdrop is cropped.
Chapter 6 Formatting Common Chart Elements 123
Note Some graphics files can be very large. In order to minimize performance
problems on some systems, it is recommended that you always clear one picture
from the backdrop before specifying a new one. This prevents the system from
having to deal with two large graphics files simultaneously.
The following illustrations show the results of resizing and repositioning chart
elements.
The custom chart was given more impact by enlarging the plot and repositioning it higher in the chart.
The border was also removed from the legend and it was repositioned slightly to better fit with the
resized plot.
Left Right
Note You can also resize or reposition objects manually. Refer to Chapter 3 for
more information about resizing and reposition objects.
These options control the Check the Word Wrap check box to wrap text that is too long to fit on one line of
vertical alignment of text. the bounding box. You can also insert line breaks manually by pressing CTRL +
ENTER anywhere in the text.
3. In the Alignment section, click the appropriate button to control the horizontal
alignment of text. You can align text on the left margin, in the center, or on the
right margin.
4. In the Alignment section, click the appropriate button to control the vertical
alignment of text. You can align text at the top margin, in the middle, or at the
bottom margin.
5. In the Orientation section, click the appropriate button to control the orientation
of the text.
6. Click OK or Apply to redraw the chart to reflect the changes.
Specifying Text
The Text tab of the Chart Designer specifies the text of axis titles, data point
labels, footnotes, and series labels.
➤ To specify text:
1. In the Chart Designer tree view, select the chart element for which you want to
specify text.
2. Select the Text tab.
Chapter 6 Formatting Common Chart Elements 127
3. In the Text text box, enter the text that you want to display for the chart
element.
4. Click OK or Apply to redraw the chart to reflect the changes.
Formatting Fonts
The Font tab of the Chart Designer specifies the font, font style, font size, and
special effects used to display text elements on a chart. You can specify font
formats for axis titles, data point labels, footnotes, labels, series labels, titles, and
legends.
Note If you select a default data point label, these options apply to all the non-
custom data point labels. If you select a specific data point label, these options
apply to only that data point label and override any default data point settings.
3. Select a font from the Font list. A list of fonts installed on your Windows
system is available.
4. Select a style from the Font Style list. A list of supported styles for the font you
selected is available.
5. Select a size from, or type a valid size in the Size combo box.
6. Check either or both of the Strikeout and Underline check boxes to apply those
effects to the text.
128 First Impression ActiveX User’s Guide
7. In the Color list, choose a predefined color or click Custom to create your own
color.
8. Click OK or Apply to redraw the chart to reflect the changes.
129
C H A P T E R 7
Formatting Plots
There are a number of formatting options that you can specify for 2D and 3D
charts. This chapter discusses how to:
■ Format chart plot walls.
■ Format chart plot bases.
■ Customize the appearance of chart plots.
■ Control chart direction.
■ Control bar spacing.
■ Change the 3-D view.
■ Change the 3-D lighting.
Some tabs in the Chart Designer are available for all the charts. However, some
tabs only apply to certain charts such as 3-D charts. The following sections
describe which tabs apply to certain charts, as well as how to use the tabs to apply
chart settings. For more information about pie, bubble, contour, and elevation
charts, refer to Chapter 11.
130 First Impression ActiveX User’s Guide
A wall setting is not specified for this chart. This chart is drawn with a five point wall width, a
solid pen style, a four point pen width, and a black
pen color.
The default base setting (18 points) is applied to This chart is drawn with a 36 point base height, a
this chart. solid pen style, a two point pen width, and a black
pen color.
132 First Impression ActiveX User’s Guide
The following sections describe how to customize the appearance of chart plots
using the options in this tab.
■ Start Angle. This setting allows you to specify the start position of charts. A
start angle of 0 indicates a 3 o’clock position. A start angle of 90 degrees
moves the starting position to 12 o’clock if the direction is set to
counterclockwise, or to 6 o’clock if the direction is set to clockwise. The value
is displayed in degrees, radians, or grad, depending on your selection in the
Angle Units list in the Other tab. The following illustrations show start angles
specified at different degrees
■ Scale Angle. This setting specifies where you want to display the scale on the
chart. Angles are measured in the direction specified by the Clockwise check
box. A value of 0 starts at the 3 o’clock position.
■ Angle Units. This setting allows you to select the unit of measure for all the
angles in the chart. This affects the unit of measure used for: drawing the angle
(Y coordinate) in a polar chart; the starting angle for polar, pie and doughnut
charts; scale angle for radar and polar charts; and the rotation and elevation of
3D charts. Choose degrees, radians, or grads.
Bar Gap of 0. Bar Gap of 100 percent. Bar Gap of -50 percent.
■ X Gap Ratio. The X Gap Ratio controls the distance between individual bars on
the X axis of a 3D bar chart and the space between categories of bars on 2D bar
and hi-lo charts. The following illustrations show various X Gap settings.
■ Z Gap Ratio. The Z Gap Ratio controls the distance between series of bars on
the z axis of a 3D chart. The following illustrations show various Z Gap
settings.
X Gap of 0 X Gap of 0
Z Gap of 0 Z Gap of 300
➤ To make the secondary Y axis show a different scale than the primary Y axis:
1. Uncheck the Uniform Axes check box.
2. Click OK or Apply to redraw the chart to reflect the changes.
3. To change the axis scale display for the secondary Y axis, select the secondary
Y axis node in the tree view, then change the settings on the Value Scale tab.
For more information on axis scaling, see “Specifying Settings Common to All
Axes” on page 151.
This chart has an elevation of 0. This chart has the default elevation of 30 degrees.
138 First Impression ActiveX User’s Guide
■ Rotation. This setting specifies the angle the chart is turned from the viewer. If
you are using an angle measurement other than degrees, enter the proper
equivalents. The following illustrations show rotation settings at 90 degrees and
60 degrees.
This chart has a rotation of 90 degrees. This chart has the default rotation of 60 degrees.
■ Viewing Distance. This setting represents the distance from which the chart is
viewed as a percentage of the depth of the chart. The perspective of an object
changes as you move closer to it or farther away from it. The same is true of a
3D chart. By default, 3D charts are viewed from a distance of 200 percent of
the chart’s depth. The following illustrations show the same chart at viewing
distances of 50 percent and 200 percent.
This chart is drawn with a viewing distance of 50 This chart is drawn with the default viewing distance of 200
percent. percent.
Chapter 7 Formatting Plots 139
■ Width To Height and Depth To Height. These settings represent the percentage of
the chart’s height used to draw the chart’s width and depth. The following
illustrations show the same chart at two different width and depth settings.
This chart has a width ratio of 100 and a This chart has a width ratio of 200 and a depth
depth ratio of 200. ratio of 100.
■ Projection. This setting specifies the projection method of the chart. When you
look at a 3D chart on a computer screen or a printed piece of paper, you are
looking at an object that is specially drawn to give a 3D appearance in a 2D
plane. The following illustrations show the same chart drawn using perspective,
oblique, and, orthogonal projection methods.
100
100 80
80 60
60 40
40 20
20 0
0
1993
Oblique
Perspective
Orthogonal
140 First Impression ActiveX User’s Guide
3. Enter a number between 0 and 90 degrees in the Elevation text box to control
the relative height from which a chart is viewed.
4. Enter a number between 0 and 360 degrees in the Rotation text box to specify
the angle that the chart is turned from the viewer.
5. Enter a positive number that represents the distance from which the chart is
viewed as a percentage of the depth of the chart in the Viewing Distance text
box.
6. Enter a positive number in the Width to Height and Depth to Height text boxes
to represent the percentage of the chart’s height used to draw the chart’s width
and depth.
7. Select a projection setting from the Projection list. The following table
describes the settings:
Projection Description
Oblique This is sometimes referred to as 2.5 dimensional. The chart has depth,
but the XY plane does not change when the chart is rotated or elevated.
Orthogonal Perspective is not applied to the chart. The advantage of using this type
of projection is that vertical lines remain vertical, making some charts
easier to read.
Perspective This provides the most realistic 3D appearance. Objects farther away
from you converge toward a vanishing point.
■ Edge Intensity. Edge lights vary the illumination of the edges of the chart
elements. An edge light intensity of 0 draws the edges as black lines. An edge
light intensity of 100 percent fully illuminates the edges using the edge pen’s
color. The default edge pen color is the same as the series fill color. The
following illustrations show charts displayed with edge light set at 0 percent and
100 percent.
■ Light sources. Light sources control infinite light. An infinite light source
means that while there is a direction towards which the light shines, there is not
a fixed distance from which the light is shone. The position of the light source
is at infinity with reference to the chart. This allows a more uniform
illumination and shading of the chart surfaces. At an intensity of 100 percent,
chart surfaces perpendicular to the light source are fully illuminated. At an
intensity of 50 percent, these surfaces receive 50 percent illumination from this
light. You can “turn on” or “turn off” up to nine preset infinite light sources on
your chart. A setting of 0 turns off the light source. The following illustrations
show charts displayed with various light source settings.
3. Enter a number between 0 and 100% in the Ambient Light text box to control
how light shines on all sides of chart elements, and is cast in addition to light
from fixed light sources.
4. Check the Edge Intensity check box to use edge lights. Alternatively, uncheck
the Edge intensity check box to disable edge lighting.
Enter a number between 0 and 100 percent in the Edge Intensity text box to
specify the amount of lighting applied to the edges of 3D objects such as bars,
lines, pies or doughnuts.
5. For each of the light sources, enter a value between 0 and 100 percent in the
Light Source Intensities text boxes.
6. Click OK or Apply to redraw the chart to reflect the changes.
Important A chart surface’s total illumination is the sum of the contributions of the
ambient light and each of the infinite lights.
Tidestone
145
C H A P T E R 8
Formatting Axes
Axis Terminology
Axes can be identified by their position or by their function.
Position In terms of their position, axes can be identified as X, Y, and Z axes. In
general, X axes are horizontal and show category information, while Y axes are
vertical and show value information. Z axes appear only on 3D charts to show
depth. They usually display series information. For special chart types like polar,
radar, pie, and Gantt, the X, Y, and Z axes function differently. See “Common Axis
Elements” on page 147 for information on axes and special chart types.
Function In terms of their function, axes can be identified as value axes, category
axes, or date/time axes. Category axes have text labels identifying the category or
series in the chart. Value axes display numbers as values or percents. Date/time
axes display a range of dates and times.
It is important to know the position and function of the axes in your charts,
because any formatting applied to an axis is maintained when you switch to a new
chart type.
146 First Impression ActiveX User’s Guide
Ticks
Major Divisions
Minor Divisions
Grid Lines
Value (2nd Y)
Value (Y) Axis
Axis
Almost all charts display the category (X) axis horizontally. However, both Gantt
and horizontal bar charts display the category (X) axis vertically along the left side
of the chart. Gantt charts display the date/time (Y) axis along the bottom of the
chart. Horizontal bar charts display the value (Y) axis along the bottom of the
chart.
The axis elements on radar and polar charts are slightly different. The following
illustration shows the axis elements displayed on these two types.
Radar Chart
Perf.
10
Service 2 Price
Value Axis
grid lines Radar Axis grid lines
Ease
Polar Chart
90
4.0
Angle Axis grid120 60
lines 3.0
150
2.0
30 Value (Y)Axis
1.0
180 0.0 0
Angle Axis
210 330
240 300
270
Value Axis grid
lines
Note Pie and doughnut charts have no axis information. They use the format
settings for X axis labels to format the labels on the pieces of the pie or doughnut.
150 First Impression ActiveX User’s Guide
60 60
50 50
40 40
30
30
20
20
10
10
0
Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 0
■ Automatic (Scale). This setting allows you to let First Impression scale the axis
based on the data being charted.
■ Ticks (Style). These settings allow you to select a style to specify the position of
the tick on the axis.
■ Ticks (Length). This setting allows you to enter a length in points for the major
tick marks. Minor tick marks are drawn at half the length of the major tick
marks.
■ Automatic (Intersection). This setting allows you to automatically have the axes
intersect at their usual position.
■ Cross At. This setting allows you to specify the position where you want the
current axis to cross its intersecting axis.
152 First Impression ActiveX User’s Guide
■ Labels Inside Plot. This setting allows you to move the axis labels with the axis
to the new intersection point or leave the labels in their original position. If you
move axis labels, labels might display on top of the chart plot. Only the axis
line and tick marks are drawn at the new intersection point. The following
illustrations show a moved axis intersection.
200 200
100 100
0 0
-100 -100
-200 -200
-300 -300
-400 -400
-500 -500
’84 ’85 ’86 ’87 ’88 ’89 ’90 ’91 ’92 ’93 ’84 ’85 ’86 ’87 ’88 ’89 ’90 ’91 ’92 ’93
Normal Axis Position X axis intersection has been moved to 0 on the Y axis.
Axis labels are still drawn in the original axis position.
200
100
0
’84 ’85 ’86 ’87 ’88 ’89 ’90 ’91 ’92 ’93
-100
-200
-300
-400
-500
X axis intersection and axis labels have been moved to O
on the Y axis.
➤ To display the Category Scale tab, Value Scale tab, or Date Scale tab:
1. In the Chart Designer tree view, select the appropriate axis to format the scale
settings.
2. Select the Category Scale, Value Scale tab, or Date Scale tab.
3. Once the appropriate tab is displayed, format the axes using the procedures
listed in the following sections.
3. In the Axis Pen section of the Pens tab, select a predefined width from the
Width list, or select Custom to define your own width.
4. From the Color list, select a predefined color or click Custom to create your
own color.
5. Click Apply or OK to redraw the chart to reflect the changes.
➤ To change the style, width, and color of the minor or major grid pen:
1. In the Minor Grid Pen or Major Grid Pen section of the Pens tab, select a pre-
defined style from the Style list, or select Custom to define your own width.
2. Select a predefined width from the Width list, or select Custom to define your
own width.
3. From the Color list, choose a predefined color or click Custom to create your
own color.
4. Click Apply or OK to redraw the chart to reflect the changes.
Chapter 8 Formatting Axes 155
The following includes specific information about these category scale settings.
■ Per Label. This setting allows you to set divisions for labels. A value of 1 labels
every division. A value greater than 1 labels the first division and skips the
labels for the extra divisions.
■ Per Tick. This setting allows you to set divisions for ticks. A value of 1 places a
tick mark at every division. A value greater than 1 places a tick mark at the first
division and skips the tick marks for the extra divisions.
Skipping labels and tick marks can help reduce the clutter of labels that can occur
when you have a large number of divisions. The following illustration
demonstrates the use of this option.
100 100 100 100
90 90 90 90
80 80 80 80
70 70 70 70
60 60 60 60
50 50 50 50
40 40 40 40
30 30 30 30
20 20 20 20
10 10 10 10
0 0 0 0
Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec Jan Apr Jul Oct
In order to minimize the clutter of labels on the first chart, Divisions per label is set to 3. The
first label is displayed, two are skipped, and then another label displayed. Ticks are still
displayed at every division
156 First Impression ActiveX User’s Guide
2. Select the Y axis that you DON’T want to display an X axis. Y axes are stacked
by ascending order of their numbers, so Y1 is on the bottom, Y2 above that, Y3
above that, etc. You may select more than one.
3. Click Apply or OK to redraw the chart to reflect your changes.
The minimum and maximum values represent the lowest or beginning value and
the highest or ending value that is displayed on the scale. You can also specify the
major divisions that you want on the axis, and the number of minor divisions
between each major division of the axis.
Note The only scaling change you can make for a radar axis is to turn the display
of the axis on or off. Unchecking the Show check box turns off the category labels
at the end of each value axis. The value axes on a radar chart can be formatted like
any other value axis.
Note The radius axis on a polar chart can be formatted just like any other value
axis. Scaling the polar axis allows you to control the number of radial grid lines
and labels that are displayed around the perimeter of the chart.
4. Enter the highest or ending value for the scale in the Maximum text box.
5. Enter the major divisions that you want on the axis in the Major text box.
6. Enter the minor divisions that you want between each major division of the axis
in this text box.
7. Click Apply or OK to redraw the chart to reflect the changes.
10000
1000
100
10
1
1700 1800 1900 1950 1970 1990 2000
■ Log Base. This setting specifies the logarithm base for a logarithmic scale axis.
The default base is 10.
■ Percent Basis. This setting specifies a methods for calculating percentages.
■ Axis Length (% of Plot). This setting lets you determine how much space each
multiple Y axis takes up in the plot of the chart. For charts that do not have
multiple Y axes, this option does nothing. For more information on multiple Y
axes, see “Formatting Charts with Multiple Y Axes” on page 209.
160 First Impression ActiveX User’s Guide
3. Select the appropriate radio button for axis scaling. The following table
describes the choices:
Type Description
Linear Data points are plotted in a linear scale with values ranging from the
minimum to the maximum chart value. This is the default scale type.
Logarithmic Data points are plotted in a logarithmic scale with values based on a
specific log scale. Logarithmic axes are not appropriate for zero or
negative data.
Percent Data points are plotted in a linear scale as percentages of the chart
values. Changing the percent basis of a chart is useful for determining
overall the trends in data rather than specific values.
4. If you select the Logarithmic radio button, enter a number in the Log Base text
box for the logarithm base.
Chapter 8 Formatting Axes 161
5. If you select the Percent radio button, select a percentage type from the Percent
Basis list. The following table describes the options:
Percentage Type Description
Chart Maximum The largest value in the chart is considered 100 percent and all
the other values on the chart are displayed as percentages of that
value.
Category Maximum The largest value in each category is considered 100 percent and
all the other values in that category are displayed as percentages
of that value.
Series Maximum The largest value in each series is considered 100 percent and
all the other values in that series are displayed as percentages of
that value.
Chart Total All the values in the chart are added together, and that value is
considered 100 percent. All the values in the chart are displayed
as percentages of that value.
Category Total All the values in each category are added together to give a total
value for each category. All the values are displayed as a
percentage of their category total.
Series Total All the values in each series are added together to give a total
value for each series. All the values are displayed as a
percentage of their series total.
Check this check box to not display dates that fall on weekends. Uncheck
this check box to display all the dates regardless of the day of the week.
The Minimum and Maximum values represent the lowest or beginning date and/or
time and the highest or ending date and/or time that is displayed on the scale. You
can also specify how many intervals pass before a tick mark is placed on the axis.
4. Select an interval type from the list to specify when tick marks are displayed.
The major ticks and grid lines appear at major intervals, and the minor ticks
and grid lines appear at minor intervals. Axis labels are drawn at major
intervals. The following table describes the settings for these options.
Type Description
None No tick marks or axis labels appear.
Yearly A tick mark appears on January 1.
Monthly A tick mark appears on the 1st of the month.
Semi-monthly A tick mark appears on the 1st and 15th of the month.
Weekly A tick mark appears on Mondays.
Daily A tick mark appears per day.
Hour A tick mark appears per hour.
Minute A tick mark appears per minute.
Second A tick mark appears per second.
Millisecond A tick mark appears per millisecond.
For example, to make the major interval be a quarter of a year, set the number
of major divisions to 3 and set the interval to months.
5. Click Apply or OK to redraw the chart to reflect the changes.
164 First Impression ActiveX User’s Guide
Major interval
Extra interval 1
Extra interval 2
Chapter 8 Formatting Axes 165
2. In the small text box, enter the number of time units that must pass before the
interval is marked.
3. Select a time unit from the list box. For example, if you enter 6 in the small text
box and choose Months in the Interval list box, a tick mark and axis label (if
desired) will appear every six months. The intervals are the same as the Major
and Minor intervals, described in the table above.
4. Click OK or Apply to redraw the chart and see your changes.
To label the tick marks, choose the appropriate date and/or time label format in the
Designer Date Formats Tab, discussed below.
166 First Impression ActiveX User’s Guide
Note First Impression displays dates and times in this tab using the Windows
environment date format assigned though the Control Panel. A confusing situation
can occur when using dates earlier than 1920. If you have your date format set to
not show centuries, the Date Scale tab assumes the date displayed is between
1/1/1920 and 12/31/2019. So, if you have a date axis minimum of Jan 1, 1905,
displayed as 1/1/05, First Impression converts it to Jan 1, 2005. The solution is to
use centuries in your Windows date format if you want to deal with dates outside
the range 1/1/1920 to 12/31/2019.
Chapter 8 Formatting Axes 167
3. Select a date/time format from the Major Formats list to indicate the major
date/time distinction.
4. If you want to apply a second level of labels, select a format from the Extra
Intervals 1 list to indicate the interval.
5. If you want to apply a third level of labels, select a format from the Extra
Intervals 2 list to indicate the interval.
6. Click Apply or OK to redraw the chart to reflect the changes.
Note Label formats for date/time axes can also be set by selecting the Axis Labels
node for the date/time axis and clicking on the Format tab. Changes you make in
the Date Formats tab will be reflected in the Format tab, and vice versa.
Tidestone
169
C H A P T E R 9
There are a number of things that you can do to format series data or data points in
a chart. You can:
■ Plot series data from rows or columns in the data grid.
■ Change how series data is displayed.
■ Reorder series data.
■ Hide or exclude a series.
■ Plot the series on a secondary Y axis.
■ Add or modify markers used to identify series elements or individual data
points.
■ Change the appearance of the elements that make up the series.
■ Add guidelines or statistics lines to highlight series information.
■ Change the fill and line colors used to display series elements or individual
data points.
■ Change the color and pattern of the edge pen used to display series elements.
■ Control data point markers for a series.
■ Reset data points to their default settings.
3. Select All Series from the Series list to change the display of all the Series data.
Alternatively, select an individual row or column label to change the display of
the data for it.
Chapter 9 Formatting Series and Data Points 171
4. In the Display As list, select the series type you want to use to display data
from the Display As list.
5. Click OK or Apply to redraw the chart to reflect the modifications.
Reordering Series
The Order tab of the Chart Designer changes the order in which the series in a
chart is displayed. This can be particularly useful if one series obscures the view
of the data in another series. By rearranging the series, you can find the most
aesthetically pleasing way to present your data.
The Series Order list shows the list of all the series in
the order they are drawn on the chart.
The following illustrations show the result of moving the series labeled Europe in
front of the series labeled Asia.
Notice that
more data is
visible in the
new drawing
order.
Before After
You can also use the buttons on the Order tab to stack and unstack series and to
change the order of stack series.
Use the Show Markers and Automatic Markers check boxes to set defaults
for any data points that you display.
The last series in each category is hidden. The last series in each category is excluded.
The following illustration shows how hiding a series in a stacked chart can produce
floating chart elements.
■ Plot On 2nd Y Axis. Check this box to plot the current series on the secondary Y
axis, which is the axis drawn on the right side of the chart. (Do not confuse the
secondary Y axis with multiple Y axes. For more information, see “Multiple Y
Axes and Secondary Y Axes” on page 209.)
After plotting a series on a secondary Y axis, you may want to change the
scale, type, or format of the secondary axis to best display the series data.
Chapter 9 Formatting Series and Data Points 175
When an individual series is selected, the Automatic Markers check box determines that
the series automatically assigns a marker to all the non-custom data points in a series. A
non-custom data point is any data point that does not have custom attributes.
2. Check the Show Markers check box to display markers for the currently
selected series.
You can also set this option for the series at the data point level.
3. Check the Automatic Markers check box to automatically assign a marker to all
the non-custom data points in a series. Uncheck this check box to select your
own choice of marker.
Custom marker settings for a specific series disable the Automatic Markers
setting. For more information about specifying custom marker settings, refer to
“Controlling Data Point Markers” on page 188.
4. Click Apply or OK to redraw the chart to reflect your changes.
176 First Impression ActiveX User’s Guide
■ Top Ratio. The following illustration shows the effects of changing the top ratio
on several bars.
Top Ratio of 0
Chapter 9 Formatting Series and Data Points 177
Note Gains and losses are calculated differently between open-hi-lo-close bar
charts and other variations of hi-lo-close charts. A hi-lo-close chart calculates
whether the close value for a point was a gain or a loss from the close value of the
previous point. In other words, the first data point never has a gain or loss color,
but sets the basis for deciding if the next data point displays a gain or loss. The
open-hi-lo-close bar chart calculates whether the close point was a gain or loss
from the open value for the same point.
180 First Impression ActiveX User’s Guide
3. Specify the options as described in the following steps, and click OK or Apply
to redraw the chart to reflect the changes.
Important Very acute mitered joins are automatically beveled to avoid drawing
large spikes along the line.
Rounded
Beveled
Mitered
Squared
Butt
3. After you modify the settings, click OK or Apply to redraw the chart to reflect
the changes.
For specific information about each of these settings refer to “Formatting Series
Lines” on page 180.
184 First Impression ActiveX User’s Guide
Maximum Value
Mean Value
Minimum Value
3. Specify the options as described in the following steps, and click OK or Apply
to redraw the chart to reflect the changes.
2. For each type of statistic, select a line style from the list that uniquely identifies
it.
3. In the Width list, select a preset line width or select Custom to assign your own
width.
4. In the Color list, choose a predefined color or click Custom to create your own
color.
5. Click OK or Apply to redraw the chart to reflect the changes.
4. From the Color list, choose a predefined color or click Custom to create your
own color.
5. From the Size list, select a size for the marker.
6. From the Pen Width list, select a preset line width or select Custom to assign
your own width.
7. Click OK or Apply to redraw the chart to reflect the changes.
There might be times that you want to highlight one or more data points in a series.
To highlight individual data points, you apply custom settings to them. Custom
settings are defined as any variation to the default data point settings for the series.
2. Select the Markers tab to modify the marker options for the data point.
3. Specify the marker settings as described in the previous set of steps.
4. Click OK or Apply to redraw the chart to reflect the changes.
190 First Impression ActiveX User’s Guide
Note You can also fill 2D bars with pictures interactively. First copy the picture
you want to fill the bar with onto the clipboard. Then display the chart. Go into
edit mode by selecting Edit from the context menu. Select the bar you want to fill
on the chart, click the right mouse button to display the context menu, and select
Paste.
Tidestone
193
C H A P T E R 1 0
Formatting Labels
You can change the format of labels for axes, for individual data points, or for
series of data points. In addition, you can use series labels instead of a legend to
identify each series on a line, area, step, XY, polar, or radar chart. This chapter
discusses how to:
■ Change the display and format of axis labels.
■ Use and format data point labels, including location, number formats, and line
styles.
■ Use and format series labels, including location and line styles.
The following illustration shows a chart with standing label text and non-standing
label text.
Multi-Dimensional Charts
3. From the Category list, select a category to display a pre-set list of format
strings appropriate for the type of label in the Format Codes list.
4. Select one of the predefined formats from the Format Codes list. The Built-in
Number Formats table, below, shows results of applying each format.
5. Click Apply or OK to redraw the chart to reflect the changes.
Note Label formats for date/time axes can also be set by selecting the Date Axis
node for the date/time axis and clicking on the Date Formats tab. Changes you
make in the Date Formats tab will be reflected in the Format tab, and vice versa.
196 First Impression ActiveX User’s Guide
The following table shows the built-in date formats for a US English locale and the
result after the format is applied to a date.
Format 04/18/95
m/d/yy 4/18/95
d-mmm-yy 18-Apr-95
d-mmm 18-Apr
mmm-yy Apr-95
m/d/yy h:mm 4/18/95 0:00
The following table shows the built-in time formats for a US English locale and the
result after the format is applied to a time.
Format 12:02:02
h:mm AM/PM 12:02 PM
h:mm:ss AM/PM 12:02:02 PM
h:mm 12:02 PM
h:mm:ss 12:02:02
m/d/yy h:mm 4/18/95 12:02 PM
mm:ss 02:02
[h]:mm:ss 12:02:02
mm:ss.0 02:02.0
Data point labels show the value of each data point. A data point label highlights one data point.
17.7
33.4
Sun
10.1 HP
IBM
DEC
SGI
Other
8.3
10.1
20.4
Note If you select a default data point label, these options apply to all the non-
custom data point labels. If you select a specific data point label, these options
apply to that data point label only and override any default data point label
settings.
202 First Impression ActiveX User’s Guide
30 30 Team 3
20 20
Winner of Q4
10 Sales Contest 10
0 0
Q1 Q2 Q3 Q4
C H A P T E R 1 1
4. Select the type you want to use for the selected series.
5. Continue specifying types for each series as necessary.
6. Click Apply or OK to redraw the chart to reflect the changes.
The following illustration shows the results of changing the Clothing series to a
line chart and the Travel series to an area chart.
Before After
➤ To use the Chart Designer to create a chart with a computed date/time axis:
1. Set up the date/time data correctly in the data grid editor, as explained in “Data
Grids for Charts With Computed Date/Time Axes” on page 104. If your chart is
linked to a range of cells in a Formula One worksheet, the date/time data
entered in Formula One does not have to be changed.
2. In the Chart Designer, select the Chart node, click the Designer Chart Type
Tab, and choose hi-lo as the chart type.
3. Select the Series node and click the Designer Series Type Tab.
4. Select the first series in the Series box and choose the Dates type.
5. Select the second series in the Series box and select the chart type to display
that series in. You may choose from among the bar, line, area, step, hi-lo, hi-lo-
close, and open hi-lo-close types. (For detailed information about displaying
different chart series differently, see “Formatting Series Type” on page 170.)
6. Click Apply or OK to redraw the chart and see your changes.
Chapter 11 Using Complex Charts 209
7. To make your date/time axis gridlines and axis labels display the way you want
them to, you will probably want to make formatting changes usting the Date
Scale and Date Formats tabs. (For detailed information about axis settings for
date/time axes, see “Specifying Date/Time Axis Settings” on page 162.)
box, enter the percentage of the chart plot that that Y axis should take up.
Repeat this step for all the Y axes on your chart. (For detailed information
about axis length (% of plot), see page 161.)
5. Since all the Y axis share one X axis, you may choose to hide the X axis for
one or more of the Y axes. To do this, select the X axis node and click on the
Multiple Y tab. Select the X axes that you want to hide and click Apply or OK.
(For detailed information about hiding X axes, see “Specifying Category Axis
Hiding Settings” on page 157.)
Service 2 Price
Ease
Notice that since the Hi-Lo-Close chart requires three columns of data, the second and third
columns that make up the series are indented to show that they are part of the first series.
Chapter 11 Using Complex Charts 213
5. If a column in the data grid holds dates, select that series name from the Series
list, and then select the Dates series type from the Display As list.
This instructs First Impression to use the values in this column to create a
computed date/time axis for this chart. The series is automatically excluded so
that it is not actually charted. For more information about formatting a
computed date/time axis, “Formatting Charts with Computed Date/Time Axes”
on page 208.
6. Select the first series that holds stock information from the Series list.
7. Select one of the hi-lo-close variations in the Display As list.
The second and third column in every series are indented to show that the series
requires three columns of data to chart a hi-lo-close chart.
8. Select the series that contains volume information from the Series list.
9. Select the series type from the Display As list that you want to use to display
volume data. Bar, Line, and Area are typical choices for displaying volume
data.
10. Click Apply or OK to redraw the chart to reflect the changes.
Since volume information is usually very different from the high, low, and
close price of stock, you might need to follow the next steps to finish the chart.
11. In the tree view, select the Volume series for the chart.
12. If necessary, select the Options tab.
13. Check the Plot on 2nd Y Axis check box.
14. Click Apply or OK to redraw the chart to reflect the changes.
214 First Impression ActiveX User’s Guide
100 100
80 80 Phone
Gas
60 60 Electric
40 40
20 20
0 0
1992 1993 1994
■ Thickness Ratio. This setting specifies the percentage of the pie or doughnut
radius that determines the height of a 3D pie or doughnut. The higher the
percentage, the taller the pie or doughnut. The following illustrations show
various thickness ratios.
Thickness Ratio of 33
percent
Thickness Ratio of 100 percent
■ Top Radius Ratio. This setting specifies the percentage of the pie radius that is
used to draw the top of a 3D pie. A ratio of 100 draws a cylinder; values less
than 100 result in a tapering of the top of the pie. A value of 0 results in a cone.
The following illustrations show various top radius ratios.
This pie has the default thickness ratio of This pie has a thickness ratio of 60
33 percent and a top radius ratio of 100 percent and top radius ratio 65 percent.
percent.
■ Interior Ratio. This setting describes the ratio of the entire doughnut size that is
used to display the interior “hole” of the doughnut. The following illustrations
show “hole” settings.
This doughnut has an interior This doughnut has an interior This doughnut has an interior
ratio of 30 percent. ratio of 67 percent. ratio of 95 percent.
216 First Impression ActiveX User’s Guide
■ Sides. This setting controls the number of sides used to draw a doughnut. More
sides give the doughnut a rounder, smoother appearance. If you enter a value of
1 in this option, First Impression determines the number of sides needed to
draw a round doughnut based on the size of the doughnut. The following
illustrations show a doughnut with three sides, and a doughnut with 60 sides
3. Once the Pie tab is displayed, format the pie or doughnut chart using the
procedures listed in the following sets of steps.
Chapter 11 Using Complex Charts 217
➤ To position a label:
1. Select a label position from the Label Position list in the Pie tab to position the
chart labels. The following table lists the options for this setting:
Setting Description
None No label is displayed.
Above The label is displayed above the pie or doughnut.
Below The label is displayed below the pie or doughnut.
Center The label is centered on the pie or doughnut.
➤ To specify 3D settings:
1. In the 3D section of the Pie tab, enter a value between 0 and 100 percent in the
Thickness Ratio text box to control the thickness of the chart.
2. Enter a value in the Top Radius Ratio text box that represents the pie radius that
is used to draw the top of the chart.
3. Enter a number between 0 percent and 100 percent in the Interior Ratio text
box to size the “hole” of the doughnut.
4. Enter the total number of sides, up to 360, in the Sides text box for a doughnut.
5. Click OK or Apply to redraw the chart to reflect the changes.
Chapter 11 Using Complex Charts 219
7. Enter a percentage in the Largest Bubble Ratio text box to set the size of the
largest bubble in relation to the shortest chart axis. All other bubbles are sized
relative to the largest bubble.
8. Click OK or Apply to redraw the chart to reflect the changes.
2D Contour Chart
3D Surface Chart
Once you specify the chart type you wish to draw, you can format both elevation
and contour information for the chart. Contour and elevation options are divided
between two tabs in the Chart Designer. The Elevation tab contains basic contour
and surface options. The Contour tab controls the assignment of colors and line
widths used in the actual contour bands and lines. In each tab, the available options
depend on the chart type you have specified and are disabled (grayed) if they do
not apply to the current chart type.
Chapter 11 Using Complex Charts 221
■ Contour List. You can customize contours by modifying existing contours and
adding or deleting contours when the Automatic Values check box is not
checked. You can also specify value labels, that take the place of contour
values, that you wish to appear in the legend.
■ Colors. You can control how color is displayed on the chart. The options
provided for color types include Automatic, Gradient, and Manual (custom).
The following illustrations demonstrate color types for contour charts.
■ Band Styles and Colors. You can specify band styles and colors for contours.
■ Line Widths and Colors. You can specify line widths and colors for contours.
Chapter 11 Using Complex Charts 223
Uncheck Automatic Values to add values for custom contours. Check this
check box to have each major axis division represent a separate contour.
3. Once the Contour tab is displayed, format the contour or surface chart using the
procedures in the following sections.
Note Since smoothing occurs for both rows and columns, a smoothing factor of 2
breaks a surface patch into 4 subpatches while a smoothing factor of 4 breaks a
patch into 16 subpatches. Higher smoothing factors might slow drawing speed
significantly.
224 First Impression ActiveX User’s Guide
➤ To add a contour:
1. Uncheck the Automatic Values check box, if necessary.
2. Enter a contour value in the Value text box.
3. Type a value in the Label text box, if desired.
4. Click the Add button.
The value is added to the Contour list, the values are reordered, and the new
value is displayed in the appropriate location.
5. Click Apply or OK to redraw the chart to reflect the changes.
➤ To modify a contour:
1. Select a contour value from the Contour list.
2. Double-click the number displayed in the Value text box.
3. Type the new value for the contour
4. Double-click the value label displayed in the Label text box.
5. Type the new label for the contour, if desired.
6. Click the Set button.
The value is modified in the Contour list, and the new value is displayed in the
appropriate location.
7. Click Apply or OK to redraw the chart to reflect the changes.
Surface chart with surface type None. Surface chart with surface type Bands.
Surface chart with surface type Solid. Surface chart with surface type Solid with Lines.
228 First Impression ActiveX User’s Guide
■ Base. Base settings control how the base of a surface chart is represented. The
following illustrations display examples of the charts with each of the base
options selected
Surface chart with pedestal base Surface chart with standard base
Surface chart with contour bands base Surface chart with contour lines base
230 First Impression ActiveX User’s Guide
■ Contour Data Options. Contour data options control the display of both
contouring and elevation data. A contour chart displays only contour data, but a
surface chart can display both contouring and elevation data. When Use
Separate Contour Data is enabled, a surface chart displays surface contours that
do not necessarily conform to the shape of the surface. For example, a surface
chart displaying separate contour and elevation data might depict snowfall
across a mountain range. The following illustrations demonstrate how the Use
Separate Contour Data check box affects a surface chart display:
Surface chart with Use Separate Contour
Data disabled. The contour bands
conform to the shape of the surface so in
this case, elevation and contour data
illustrate the same thing on the chart.
3. Once the Elevation tab is displayed, format the chart using the procedures in
the following sections.
232 First Impression ActiveX User’s Guide
2. In the Width list, choose a predefined width or select Custom to create your
own width.
3. Select a predefined line color from the Color list.
4. Click Apply or OK to redraw the chart to reflect the changes.
Chapter 11 Using Complex Charts 233
Type Description
Pedestal The base is displayed as a solid area that rises up to meet the surface.
Standard The base is displayed as a flat area beneath the chart surface.
Bands The base reflects the chart’s contours as a series of contour bands.
Lines The base reflects the chart’s contours as a series of contour lines.
To create an elevation chart like the one displayed on the previous page, set the
following options in the Elevation tab of the Chart Designer:
The base contour colors for this chart are set in the Contour tab of the Chart
Designer:
A smoothing factor of 1 is
applied to the surface to
give the chart a realistic
looking terrain.
Index
Numerics Automatic
axis scaling 151
2D charts, elements in 42 data point markers 175
3D charts Axes
depth to height ratio of 139 color of 154
elements in 43 crossing position of 151
elevation of 137 defined 41
projection of 139 examples of 147
rotation of 138 grid lines 147
viewing distance for 138 hiding 151
width to height ratio of 139 intersection of 151
3D lighting major divisions on 147
ambient light for 141 minor divisions on 147
controlling 143 pens for 154
edge intensity for 142 scaling of, automatic 151
light sources for 142 selecting 58
3D Lighting tab 141–143 showing 151
3D scatter charts 55 tabs displayed for 150
axis types that apply to 146 ticks, length of 151
data grid requirements for 103 ticks, positioning 151, 153
3D view titles for
controlling 140 backdrops on 114–119
depth to height for 139 selecting 58
elevation for 137 types of 145
projection for 139 width of 154
rotation for 138 Axes page, in wizard 109
viewing distance for 138 Axis labels 42, 193–200
width to height for 139 automatic rotation of 193
3D View tab 137–140 built-in number formats for 195
3D XYZ charts 55 creating with the Chart Wizard 109
axis types that apply to 146 custom number formats for 197
data grid requirements for 103 divisions by 155, 156
moving 152
positioning on ticks 156
A standing labels for 193
ActiveX controls, adding 15 Axis length (% of plot) 159, 161
Aligning text 126 Axis scale, showing and hiding 152
Ambient light 141 Axis titles 42
Angles fonts for 127
starting 134 placing on a chart 64
unit of measure for chart 134 specifying text for 126
Annotating charts 201
Appearance tab 201–204
Applying changes, using the Chart Designer 68 B
Area charts 44 Backdrop tab 113–119
axis types that apply to 146 Backdrops 114–119
chart 42
defined 113
238 First Impression ActiveX User’s Guide
H J
HideXAtYIndex property 157, 211 Joining
Hiding lines 180, 181
axes 151 types 181
data point markers 188
footnotes 123
legends 123 L
lines on line charts 180 Labels
series 174 axis, see axis labels
titles 123 backdrops on 114–119
X axes on multiple Y axis charts 157 data grid, see data grid labels
Hi-lo charts 52 data point, see data point labels
axis types that apply to 146 fonts for 127
data grid for 52, 99 formatting text for 125
formatting 212 on pie and doughnut charts 214
gain and loss colors of 179 series, see series labels
series display options 170 Labels inside plot, axis setting 152, 153
using in other chart types 214 Landscape orientation, for printing 73
volume information on 213 Layout for printer button 73
with computed date/time axes 100 Layout page, in wizard 108
Hi-lo-close charts 52 Layout tab 125–126
data grid requirements for 99
Index 243
Visual C++
CFormView-based applications in
X
adding First Impression to 21 X axes 147
creating 20 hiding 157
connecting to a database using 26 X gap ratio
creating ActiveX applications in 19 controlling 136
CView-based applications in, creating 20 defined 135
dialog-based applications in XY charts 49, 96
adding First Impression to 21 data grid for 49, 96
creating 20 XYZ charts
events using 24 data grid organization for 55
getting started in 19–27
member variables in 22
methods in 23 Y
printing in 25 Y axes 147
projects in, adding First Impression to 21 see also multiple Y axes
properties in 23, 25 secondary, see secondary Y axes
remote data control in, adding First Impression to 26 YAxisCount property 211
serializing the chart control using 26 YAxisIndex property 211
sub-objects for First Impression in 23
Visual Studio 9
Volume data in hi-lo charts 213 Z
Z axes 147
W Z gap ratio
controlling 136
Wall tab 130 defined 136
Walls 43
fills for 131
pen styles for 130
selecting 58
widths for 130
Weighting, pies and doughnuts 214
Width
of axes 154
of lines in line charts 180
Width to Height ratio of 3D chart 139
Wireframe types 228
Wizard
accessing the 59, 105
Axes page in 109
Gallery page in 106
initializing chart settings in 109
Layout page in 108
modifying charts using 109
navigating in 106
selecting chart types in 106
selecting style types in 107
Style page in 107
Worksheets, importing data from 73
Wrapping text 126