ComponentOne WinForm Chart 使用指南

需积分: 16 67 浏览量更新于2024-07-25 收藏 6.29MB PDF 举报

"WinForm.Chart.pdf 是C1 Studio为WinForm平台提供的图表组件文档，主要针对2013V1版本。ComponentOne是这个WinForm图表组件的提供商，它是一款由ComponentOne LLC开发的专业控件集，适用于C#编程语言。此文档详细介绍了如何在Windows窗体应用中使用和配置Chart组件，以实现丰富的数据可视化功能。" ComponentOne Chart for WinForms是ComponentOne LLC公司提供的一款高级图表组件，旨在帮助开发者在WinForm应用程序中创建各种复杂且具有吸引力的数据可视化效果。该组件支持多种图表类型，包括折线图、柱状图、饼图、散点图等，能够满足不同数据分析和展示的需求。在C#编程环境中，ComponentOne Chart提供了丰富的API和属性，允许开发者自定义图表的颜色、样式、数据源、轴设置、图例等各个方面，以实现个性化的设计。例如，你可以通过设置Series对象来添加数据系列，通过Axis对象调整X轴和Y轴的范围和刻度，通过Legend对象定制图例的显示方式。文档中还可能涵盖以下内容： 1. **安装与集成**：介绍如何将ComponentOne Chart组件添加到Visual Studio的工具箱中，以及如何在WinForm设计界面中拖放和配置图表控件。 2. **数据绑定**：讲解如何将图表与数据库或其他数据源绑定，动态更新图表数据，支持实时数据可视化。 3. **自定义样式**：详细说明如何通过代码或设计界面调整图表元素的样式，包括线条、填充、字体等。 4. **交互功能**：介绍图表的交互特性，如鼠标悬停时显示数据提示，点击事件处理，以及缩放和平移等操作。 5. **性能优化**：提供性能调优建议，确保在大数据量下图表依然能够流畅显示。 6. **图表类型和实例**：展示不同类型的图表及其应用场景，提供示例代码以供参考。 7. **错误处理与支持**：阐述ComponentOne提供的技术支持和保修政策，包括90天内的免费更换服务和90天后的付费更换服务。 "WinForm.Chart.pdf"文档为开发者提供了关于ComponentOne Chart for WinForms组件的全面指南，无论是初学者还是有经验的开发者，都能从中获得构建高质量数据可视化界面所需的知识和技巧。

4. Use C1Lc.exe to compile the licenses.licx file. The command line should look like this:

c1lc /target:MyApp.exe /complist:licenses.licx /i:C1.Win.C1FlexGrid.dll

5. Link the licenses into the project. To do this, go back to Visual Studio, right-click the project, select properties,

and go to the Linker/Command Line option. Enter the following:

/ASSEMBLYRESOURCE:Debug\MyApp.exe.licenses

6. Rebuild the executable to include the licensing information in the application.

Using licensed components with automated testing products

Automated testing products that load assemblies dynamically may cause them to display license dialogs. This is

the expected behavior since the test application typically does not contain the necessary licensing information, and

there is no easy way to add it.

This can be avoided by adding the string "C1CheckForDesignLicenseAtRuntime" to the AssemblyConfiguration

attribute of the assembly that contains or derives from ComponentOne controls. This attribute value directs the

ComponentOne controls to use design time licenses at run time.

For example:

#if AUTOMATED_TESTING

[AssemblyConfiguration("C1CheckForDesignLicenseAtRuntime")]

#endif

public class MyDerivedControl : C1LicensedControl

{

// ...

}

Note that the AssemblyConfiguration string may contain additional text before or after the given string, so the

AssemblyConfiguration attribute can be used for other purposes as well. For example:

[AssemblyConfiguration("C1CheckForDesignLicenseAtRuntime,BetaVersion")]

THIS METHOD SHOULD ONLY BE USED UNDER THE SCENARIO DESCRIBED. It requires a design

time license to be installed on the testing machine. Distributing or installing the license on other computers is a

violation of the EULA.

Common Scenarios in Mobile Applications

The following topics describe some of the licensing scenarios you may encounter when working with Mobile

components.

Updating or renewing a license

If you renew your subscription, the new license must be installed.

If the Mobile controls are licensed through a Studio subscription, then open the About Box of either an ASP.NET

control or a .NET Windows forms control and update the license by clicking the License button and entering your

serial number.

If the Mobile controls are licensed through a Studio for Mobile Devices subscription, then open the About Box of

the 1.x version of a Mobile control or run the setup again to enter your serial number. Presently, the 2.x versions of

the Mobile controls do not have the option to license or register from the About Box; therefore, it is necessary to

license through another component or the setup.

Licensing 2.x Mobile Controls through the Setup

To enter the serial number (license) through the Studio for Mobile Devices 2.0 setup, follow these steps:

1. Run the ComponentOne Studio for Mobile Devices 2.0 setup.

2. Follow the instructions in the setup, and enter the serial number when prompted.

There are cases where the setup may not prompt you. If you have a valid license installed already, or if you are

installing a version of the controls that has already been installed (Maintenance Mode), you will not be prompted

to enter your serial number. If you need to enter your serial number for an install, and the install is running in

Maintenance Mode, you will need to uninstall first. Once you uninstall, run the install again.

If you are still not prompted for a serial number by the time you get to the install screen, you must have a valid

license in the registry on your machine. If you still need to install a new serial number, remove the old license and

then run the setup again. There is a utility available that will remove the old license for you, which can be found

below.

License Remover

The license remover will search for the following licenses on your system: Studio Enterprise, Studio for Mobile

Devices, and individual Studio Mobile product licenses. Any licenses that are found will be populated into a list so

that you can select the ones that you would like to remove. To remove a Studio for Mobile Devices license with

the license remover, follow these steps:

1. Unzip and run the C1LicBomb.exe.

2. You will see an app with a list of the installed licenses on your machine. If you see both Studio Enterprise and

Studio for Mobile devices listed, select both for removal, otherwise select the one that you see. If the new serial

number that you wish to enter for Studio for Mobile Devices is not a Studio Enterprise serial number, you will

need to enter your Studio Enterprise serial number again, but this can be done through any of the About Boxes

for C1 controls with the exception of the Mobile Studio About Boxes.

3. Select any other licenses you wish to remove, then click the Remove Selected Licenses button.

4. You will be asked if you are sure that you want to delete each key; click OK when you get the dialog box.

5. There will also be a dialog box to let you know that a particular key was removed successfully; click OK for

that one also.

6. Now you can close the program and run your Studio for Mobile Devices setup again to enter your new serial

number.

Follow through with the setup, enter your serial number when prompted, and ComponentOne Studio for Mobile

Devices will be licensed on your machine.

Updating a project after renewing a license

Once you have installed a new license, each project must be updated in order to use the new control; rebuilding the

control is not sufficient. It is necessary for the control to regenerate the license embedded in its SupportInfo

property. To do this, it is necessary to force Visual Studio to update the control properties stored in the form. The

easiest way to do this is to simply modify a property. The simplest choice is to toggle a Boolean property such as

the Visible property, and then toggle it back to its original value. This results in no changes or side effects in the

control configuration, but it forces the IDE to update SupportInfo and embed the new run-time license.

Instantiating a Mobile control at run time

The Mobile controls behave the same way as other ComponentOne controls when they are created at run time and

not placed on the form at design time. Because the IDE does not have an opportunity to obtain a run-time license

on its own in this case, it is necessary to force the IDE to include a run-time license. To accomplish this, include at

least one instance of the control on a form in the assembly that is instantiated BEFORE the dynamically created

instance is created. Once a control of the same type is licensed, all others on the form are accepted as licensed.

Troubleshooting

We try very hard to make the licensing mechanism as unobtrusive as possible, but problems may occur for a number of

reasons.

Below is a description of the most common problems and their solutions.

I have a licensed version of a ComponentOne product but I still get the splash

screen when I run my project.

If this happens, there may be a problem with the licenses.licx file in the project. It may not exist, it may contain incorrect

information, or it may not be configured correctly.

First, try a full rebuild (Rebuild All from the Visual Studio Build menu). This will usually rebuild the correct licensing

resources.

If that fails follow these steps:

1. Open the affected project.

2. Select an instance of the updated component.

3. In the Visual Studio Properties window, change any property. It does not matter which property you change;

you can change it back to the previous value.

4. Rebuild the project using the Rebuild All option (not just Rebuild) and run the solution.

Alternative 1: Follow these steps:

1. Open a new Visual Studio.NET project.

2. Add the updated component to the form.

3. Compile and run the new project.

4. Open the licenses.licx file in the new project.

5. Copy the line that starts with the namespace of the updated component (for example, C1.Win.C1Report)

and ends with a public key token.

6. Open the existing, incorrectly licensed project.

7. Open the licenses.licx file in the new project.

8. Paste the line from step 5 into this file (replace the old licensing information with the new).

9. Rebuild the project using the Rebuild All option (not just Rebuild) and run the solution.

Alternative 2: Follow these steps:

1. Open the affected project.

2. Delete the licenses.licx file from the project.

3. Add a new instance of the updated component to the form.

4. Rebuild and run the solution. The nag screen should not appear.

5. Remove the newly added component from the form.

Try each of these options multiple times, if necessary. If that still does not help, are you creating any of the controls in

code rather than design-time? If so, you must add an entry for the control in the licenses.licx file (see

http://helpcentral.componentone.com/PrintableView.aspx?ID=1886 for more information). Also if this is a website, as

opposed to an ASP.NET web application, please try right-clicking the licenses.licx file and selecting "Build Runtime

Licenses" from the context menu.

I have a licensed version of a ComponentOne product on my web server but the

components still behave as unlicensed.

There is no need to install any licenses on machines used as servers and not used for development.

The components must be licensed on the development machine, therefore the licensing information will be saved

into the executable (.exe or .dll) when the project is built. After that, the application can be deployed on any

machine, including web servers.

For ASP.NET 2.x applications, be sure that the App_Licenses.dll assembly created during development of the

application is deployed to the bin application bin directory on the web server.

If your ASP.NET application uses WinForms user controls with constituent licensed controls, the runtime license

is embedded in the WinForms user control assembly. In this case, you must be sure to rebuild and update the user

control whenever the licensed embedded controls are updated.

I downloaded a new build of a component that I have purchased, and now I'm getting

the splash screen when I build my projects.

Make sure that the serial number is still valid. If you licensed the component over a year ago, your subscription

may have expired. In this case, you have two options:

Option 1 - Renew your subscription to get a new serial number.

If you choose this option, you will receive a new serial number that you can use to license the new components

(from the installation utility or directly from the About Box).

The new subscription will entitle you to a full year of upgrades and to download the latest maintenance builds

directly from http://prerelease.componentone.com/.

Option 2 – Continue to use the components you have.

Subscriptions expire, products do not. You can continue to use the components you received or downloaded while

your subscription was valid.

Technical Support

ComponentOne offers various support options. For a complete list and a description of each, visit the ComponentOne

Web site at http://www.componentone.com/SuperProducts/SupportServices/.

Some methods for obtaining technical support include:

 Online Resources

ComponentOne provides customers with a comprehensive set of technical resources in the form of FAQs,

samples and videos, Version Release History, searchable Knowledge base, searchable Online Help and more.

We recommend this as the first place to look for answers to your technical questions.

 Online Support via our Incident Submission Form

This online support service provides you with direct access to our Technical Support staff via an online incident

submission form. When you submit an incident, you'll immediately receive a response via e-mail confirming

that you've successfully created an incident. This e-mail will provide you with an Issue Reference ID and will

provide you with a set of possible answers to your question from our Knowledgebase. You will receive a

response from one of the ComponentOne staff members via e-mail in 2 business days or less.

 Product Forums

ComponentOne’s product forums are available for users to share information, tips, and techniques regarding

ComponentOne products. ComponentOne developers will be available on the forums to share insider tips and

technique and answer users’ questions. Please note that a ComponentOne User Account is required to

participate in the ComponentOne Product Forums.

 Installation Issues

Registered users can obtain help with problems installing ComponentOne products. Contact technical support

by using the online incident submission form or by phone (412.681.4738). Please note that this does not include

issues related to distributing a product to end-users in an application.

 Documentation

Microsoft integrated ComponentOne documentation can be installed with each of our products, and

documentation is also available online. If you have suggestions on how we can improve our documentation,

please email the Documentation team. Please note that e-mail sent to the Documentation team is for

documentation feedback only. Technical Support and Sales issues should be sent directly to their respective

departments.

Note: You must create a ComponentOne Account and register your product with a valid serial number to obtain

support using some of the above methods.

Redistributable Files

ComponentOne Chart for WinForms is developed and published by ComponentOne LLC. You may use it to

develop applications in conjunction with Microsoft Visual Studio or any other programming environment that

enables the user to use and integrate the control(s). You may also distribute, free of royalties, the following

Redistributable Files with any such application you develop to the extent that they are used separately on a single

CPU on the client/workstation side of the network:

 C1.Win.C1Chart.2.dll

 C1.Win.C1Chart3D.2.dll

 C1.CF.C1Chart.2.dll (Chart for Mobile Devices)

 C1.Win.C1Chart.4.dll

 C1.Win.C1Chart3D.4.dll

Site licenses are available for groups of multiple developers. Please contact Sales@ComponentOne.com for details.

About This Documentation

Acknowledgements

Microsoft, Windows, Windows Vista, and Visual Studio are either registered trademarks or trademarks of Microsoft

Corporation in the United States and/or other countries.

ComponentOne

If you have any suggestions or ideas for new features or controls, please call us or write:

Corporate Headquarters

ComponentOne LLC

201 South Highland Avenue

Floor

Pittsburgh, PA 15206 • USA

412.681.4343

412.681.4384 (Fax)

http://www.componentone.com

ComponentOne Doc-To-Help

剩余365页未读，继续阅读

mjq263

粉丝: 1
资源: 19

ComponentOne WinForm Chart 使用指南

C1控件使用手册（C1FlexGrid）

WinForm.DynamicHelp.pdf of C1 studio

WinForm.DataObjects.pdf of C1 studio

WinForm.Cahrt3D.pdf of C1 studio

WinForm.Editor.pdf of C1 studio

WinForm.gauges.pdf of C1 studio

WinForm.Flash.pdf of C1 studio

WinForm.InputPanel.pdf of C1 studio

WinForm.excel.pdf of C1 studio

WinForm.Input.pdf of C1 studio

最新资源