Overview

Wisej supports the deployment of large sets of icons in single independent assemblies, the Icon Packs. These are normal .NET assemblies containing the icons as embedded resources. You can deploy a single file containing hundreds or thousands of icons in any format (png, svg, gif, jpg).

Our icon packs also expose every icon as a static property allowing you to use the icons programmatically. There are code snippets for each icon set in this section.

Visual Studio

When using the designer in Visual Studio, you will see the referenced icon packs in the image explorer dialog.

The explorer has three sections. On the left side you can select the icon pack, in the middle you will see the icons, on the right you will see the preview of selected icon. In the preview you will also see the icon recolored in case you selected a different color.

By default, all the monochrome icons are recolored using the icon dark or light colors defined in the theme. However, you can select a specific color for each icon using the color palette.

Designer.cs

Selected icons are added to the designer code using the resource.wx special Wisej URL.

C#

			// 
			// button1
			// 
			this.button1.ImageSource = "resource.wx/Wisej.Ext.FontAwesome/android.svg?color=Coral";

VB.NET

			' 
			' button1
			' 
			Me.button1.ImageSource = "resource.wx/Wisej.Ext.FontAwesome/android.svg?color=Coral"

Browser Cache

Icons in icon packs are returned to the browser using the resource.wx URL and are cached on the client side. However, since each icon is a web request, they are downloaded individually. Unlike the theme icons, which are all pre-loaded at once when the theme is loaded in the client.

Custom Icon Packs

You can create your own icon packs in a very easy way:

1. Create a .NET class library (VB.NET or C#)

2. Add the icon files in a directory named Resources.

3. Set all the icons build type as Embedded Resource.

Or just duplicate one of our icon packs and modify it.