Xceed Toolkit for Maui v2.0 Documentation
Creating Your First Project
Welcome to Xceed Toolkit for Maui v2.0 > Getting Started > Creating Your First Project

This page will help you get started using Xceed Toolkit for Maui.

Note that your .NET Maui application must target .NET 8+ in order to run Xceed Toolkit for Maui.

Getting the Xceed Toolkit for Maui package

From your project in VisualStudio

From your project dependencies, open "Manage NuGet package". Then, find "Xceed.Maui.Toolkit.Plus" package; typing "Xceed Maui" in the search bar should display the package in the search results. Once you have found it, install it.

When using Xceed Toolkit for Maui in a .NET 9 application on Windows & Android, the following NuGet package must be used: Microsoft.Maui.Controls 9.0.21 (or later)


Using the Xceed Toolkit for Maui

When your project is referencing the valid Xceed Toolkit for .NET Maui dlls, you can use a Light or Dark UserAppTheme in your application. The interface will automatically adjust to the UserAppTheme in order to set the colors of the toolkit's controls.

Using Xceed Toolkit for Maui - Example 1
Copy Code
<Application xmlns="http://schemas.microsoft.com/dotnet/2021.maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:local="clr-namespace:MauiApp11"
UserAppTheme="Dark"
x:Class="MauiApp11.App">

You can then set one of the 48 Accent colors, which will be applied to each control in the Toolkit.

This can be done through the UseXceedMauiToolkit() method. To do so, go in your MauiProgram class & add the following : Xceed.Maui.Toolkit.

Then, in the CreateMauiApp() method, add the ".UseXceedMauiToolkit()" to the builder:

Using Xceed Toolkit for Maui - Example 2
Copy Code
var builder = MauiApp.CreateBuilder();
builder
  .UseMauiApp<App>()
  .UseXceedMauiToolkit( FluentDesignAccentColor.Blue )
  .ConfigureFonts( fonts =>
    {
      fonts.AddFont ( "OpenSans-Regular.ttf", "OpenSansRegular" );
      fonts.AddFont ( "OpenSans-Semibold.ttf", "OpenSansSemibold" );
    } );

Keep in mind that for this example, we are using Blue. However, we offer a total of 48 different accent colors, each with its own variations. To see the complete list, type AccentColor="" to access the enumeration.

Alternatively, add the FluentDesign ResourceDictionnary:

Using Xceed Toolkit for Maui - Example 3
Copy Code
<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:MauiApp11"
             xmlns:xctk="clr-namespace:Xceed.Maui.Toolkit;assembly=Xceed.Maui.Toolkit"
             UserAppTheme="Dark"
             x:Class="MauiApp11.App">
  <Application.Resources>
  <ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
      <xctk:FluentDesign AccentColor="Blue"/>
    </ResourceDictionary.MergedDictionaries">
  </ResourceDictionary>
</Application.Resources>


Integrating Xceed Toolkit for Maui controls

To integrate the controls, first add a namespace in the Mainpage.

 

Then, integrate the Xceed controls so that you can use & style them.

Integrating the controls - Example 1
Copy Code
<VerticalStackLayout>
  <xctk:DoubleUpDown Value="25"/>
  <xctk:TextBox Text="ABC"/>
  <xctk:Expander/>
</VerticalStackLayout>


Custom Styling

Xceed Toolkit for Maui supports custom styling. Here is how to get started :

First, create your own style that targets the Toolkit's controls.

Custom Styling - Example 1
Copy Code
<Style TargetType="xctk:Button"
       BasedOn="{StaticResource FluentDesignButton}">
  <Setter Property="Background"
          Value="Red"/>
  <Setter Property="overrideDefaultVisualStates"
          Value="True"/>
</Style>

The BasedOn needs to be set to the name of our resource. Here's the list of names that you an use for other controls:

Note that the OverrideDefaultVisualStates will allow you to change the style of a control while overriding Xceed's VisualStates.

 

See Also