Getting Started

When you're ready to implement the Data Visualization product, the following steps will get you started.

Add NuGet Package

Data Visualization is included with the ActiproSoftware.Controls.Avalonia.Pro package (view on nuget.org), so add a reference to that package. This should automatically include its transient dependencies as well.

For additional information on NuGet packages, please refer to the NuGet Packages and Feeds topic.

Configure Themes

Controls available in the Data Visualization product rely on Actipro's themes.

Actipro's themes can be integrated by adding a special ModernTheme class, which inherits Avalonia's Styles class, to an application's Application.Styles collection.

The ModernTheme class has several settings that tell it which theme assets to dynamically load into the Application, making them available for use. By default, the "Pro" control themes are not loaded and must be explicitly included when defining the theme.

The following example demonstrates defining an instance of ModernTheme directly in Application.Styles in XAML with support for Pro controls:

<Application
	x:Class="MyCompany.App"
	xmlns="https://github.com/avaloniaui"
	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
	xmlns:actipro="http://schemas.actiprosoftware.com/avaloniaui"
	>
	<Application.Styles>

		<!-- NOTE: Any Styles included above the ModernTheme can be overwritten by the Actipro themes -->

		<actipro:ModernTheme Includes="Pro" />

		<!-- NOTE: Any Styles included below the ModernTheme cannot be overwritten by the Actipro themes -->

	</Application.Styles>
</Application>

See the Themes Getting Started topic for additional details on working with themes.

Evaluate or Register a License

Data Visualization is a paid product that is included with a Pro license. During the evaluation phase, a popup will be shown the first time most Pro controls are used. Follow the "Hide This Prompt" steps on the prompt for details on how to temporarily suppress the prompt during evaluation.

Once a license is purchased (or a short-term evaluation license is obtained), the license must be registered during application startup to prevent the licensing prompt from being displayed.

See the section Licensing topic for more details on licensing, including how to apply a license.

Getting Started with Barcodes

See the Barcodes Overview for topics related to presenting barcodes and the various symbologies that are supported.

Explore the Sample Browser Examples

Numerous QuickStarts for Data Visualization are in the sample project. Each QuickStart focuses on a specific feature area and provides some great code that you can look at to use in your own applications.

See the Samples topic for more information on accessing the sample project.