If you downloaded the trial version, no registration
key is required. Simply run the installation. After 5 minutes, XY Chart NET
will stop working and a message box will appear. Simply, stop and
restart the application, and XY Chart NET will work for
another 5 minutes.
Once you have purchased a license, you will
be given a unique registration key specific to you, and you will
be directed to download the full install version.
Step 1: Install XYChartNET
Run setup.exe from the application's installation package
Step 2: Enabe XYChartNET Component
Open an existing Visual Studio project.
Activate any form "[Design]" window.
Open the Visual Studio Toolbox.
Right-click on the mouse over any item in the Toolbox and select
Add Tab.
Enter "ControlEng" as the tab name.
Open Windows Explorer and navigate to XYChartNET's installation
folder.
Select XYChartNet.dll and drag the item onto the newly created
tab.
XYChartNET component is now available for use.
Step 3: Uninstall XYChartNET
Launch 'Add or Remove Programs' (via Start > Settings >
Control Panel).
Select program to remove, 'XY Chart NET'.
Click on Remove.
Open an existing Visual Studio project.
Activate any form "[Design]" window.
Open the Visual Studio Toolbox.
Select "ControlEng" tab, right-click on the mouse
and select Delete Tab.
3. Distributing XY Chart NET for run time applications
XY Chart NET is a standalone
product and does not require any other files to be installed
other than the Microsoft .NET 1.1 Framework. The .NET 1.1 framework
must be installed on the computer where your application containing
XY Chart NET will run. The Microsoft .NET Framework
is available for download at the Microsoft
.NET 1.1 downloads page.
Copy the XYChartNet.dll
file to the same directory as your main executable.
4. If I compile my program and distrubute only the XYChartNET.dll
file to my customers, do I have to pay royalties?
No. Runtime distribution licenses are free.
Specifically, if you only distribute the XYChartNet.dll
file and do not allow your customers to develop software using XY Chart NET,
then there are no runtime royalties.
If your customers can develop software using
XY Chart, then this is effectively giving them a developer
license. Therefore, in this case, a developer license must be purchased.
5. What is the maximum size of the ChartData array?
All arrays are 0-based. The maximum number
of profiles is 250000. Every point in every profile requires an
X and Y value. Hence, the maximum number of columns is 2 x 250000 profiles = 500000 columns.
The maximum number of samples per profile is 1000000. Therefore,
the maximum size of the ChartData array is 500000 columns x 1000000
rows (see table below).
6. What is automatic zoom, scrollbars, pan, crosshairs and coordinates?
Automatic is exactly that. No programming
is required. By enabling the XY Chart NET toolbar, the zoom,
scrollbars, pan, crosshairs, and coordinates display functions are
automatically available to the user. This Two Minute Demo
best illustrates these functions.
7. What is the maximum number of Y scales, X scales and profiles?
Up to 10 Y scales and 10 X scales are available.
Up to 250,000 profiles can be mapped to any of the 10 Y scales and
10 X scales. For more detials, see Maximum size of the ChartData array.
8. Can a number of profiles be displayed while their corresponding
Y Scale is not?
Yes. Each Y Scale can be made visible or hidden
independent of the profiles mapped to it. The toolbar can also be
hidden. This is usually done to save space, allowing the plot area
to be larger. All scaling functions continue to work as though the
Y Scale is displayed. See sample images below.
DateTime support allows the display of date
and/or time values to be displayed on any X or Y axis. The DateTime
format is implemented as a floating-point value (double), measuring
days from midnight, December 30, 1899. So, midnight, December 31,
1899 is represented by 1.0. Similarly, 6 AM, January 1, 1900 is
represented by 2.25.
Note that the '.fff' format denotes miliseconds,
which is the smallest DateTime number format supported.
E.g. For a value of 38045.40279, the format
strings below yield the following results:
Format String
Result
h:mm:ss
9:40:00
hh:mm:ss.fff
09:40:00.056
hh:mm:ss tt
09:40:00 AM
m/d/yy
2/28/04
dd-mmm-yyyy
28-Feb-2004
mmmm dd, yyyy
hh:mm:ss tt
February 28, 2004 09:40:00
AM
' The X scale formatting
can also be set programitically as per the following:
With XYChart
.XScale(1).FormatStyle = fsDateTime
.XScale(1).DateTimeFormat = "dd-mmm-yyyy
hh:mm:ss tt" ' X value
= 38045.40279 will display 28-Feb-2004 09:40:00 AM
End With
Note: The following two issues only apply to the Trial version, which requires access to the Registry to manage the Trial license. The Lite & Pro fully licensed versions are not affected.
Issue 1: Administrator Rights
The Trial version is successfully downloaded
and installed on a Windows Vista/7 machine with VS2005/2008. Users
are able to place the control in the Toolbox. But when the control
is dragged and dropped on a Windows Form, the following error message
occurs:
"Failed to create component 'XYChartNETCtl'.
The error message follows:
System.Security.SecurityException: Requested registry access
is not
allowed at System.ThrowHelper.ThrowSecurityException(..."
Cause:
Administrator permissions are required with the Trial version.
Solution:
To run Visual Studio as an Administrator, right-click on Visual
Studio and select "Run as Administrator" per the screenshot below. The
control should drop on the form with no exceptions being generated.
Issue 2: 64-bit Systems
When running the Trial version on 64-bit systems, the following error message occurs:
"SetRegTimeStamp - Unable to open Registry Key"
Cause: XY Chart NET is a 32-bit control. So the target CPU needs to be specified as "x86".
Solution: Open the project properties, select the "Compile" tab, then click on the "Advanced Compile Options" button. Set the Target CU to x86, per the screenshot below.
Scientific
charts for .NET Developers
