Icon Library
- 3 minutes to read
The DevExpress Icon Library includes multiple diverse icons and images created by our design team. The collection provides both full color and grayscale images in PNG and SVG formats that you can use to decorate UI elements of your application. Shipped as part of the Express Cross Platform Library, the DevExpress Icon Library is installed in the “<DevExpress VCL installation folder>\ExpressLibrary\Sources\Icon Library” folder. All image files are arranged into collections and categories (that is, folders and subfolders within the Icon Library) corresponding to their core themes (such as “Grayscale Images”, “Office 2013”, etc.) and purposes (“Arrows”, for instance). You can place custom folders with images to the Icon Library root folder to be able to browse and select them in the same manner as built-in icons, via the “Image Picker” dialog.
Image Picker
“Image Picker“ is a design-time dialog that you can use to browse the Icon Library and select required images for a target control. The dialog can limit the icon list displayed within the gallery according to the specified filtering criteria, such as collections, categories, sizes, and the current image name entry.
Different DevExpress components provide different design-time UI that you can use to invoke the “Image Picker” dialog:
TcxImageList;
TcxImageCollection.
TcxImageList
Click the TcxImageList component’s “Edit…” popup menu item to invoke the Image List Editor. Then click the “Add Image” button or press the Alt+Ins key combination to invoke the “Image Picker” dialog.
The Image Picker automatically sets the image dimensions filter corresponding to the image list’s current pixel width and height (32 by 32, for instance). All listed vector images automatically scale to the target dimensions.
TcxImageCollection
Click the TcxImageCollection component’s “Add Images from Icon Library…” popup menu item to invoke the Image Picker.
Alternatively, you can click the “Edit…” menu item to open the collection editor, create or select an image collection item, and double-click its Picture property value field in the Object Inspector to invoke the “Image Picker” dialog.
Custom Image Library Content
The DevExpress Icon Library scans the “<DevExpress VCL Installation folder>\ExpressLibrary\Sources\Icon Library” folder once per IDE session when you invoke the “Image Picker” dialog for the first time, and populates its image gallery and the “Collection”, “Categories”, and “Size” lists with the retrieved content. You can add custom folders with images to the “Icon Library” folder to extend the list of categories and icons available via the “Image Picker” dialog.
Note
The DevExpress VCL products installer erases the “Icon Library” folder on every update and repair operation. If you store any custom folders and files in this folder, create a backup prior to running the installer to be able to restore them at the original position.