Winforms: High DPI Aware Image Collection Example

This sample demonstrates how to build a High DPI–aware Windows Forms application by using the Syncfusion ImageListAdv component. It shows how to supply different image resources for various DPI scales and automatically render the most appropriate image at runtime based on the system’s DPI setting.

Overview

Modern displays often run at different DPI scaling levels such as 125%, 150%, or 200%, which can cause icons and images to appear blurry when a single image source is used. This example illustrates how ImageListAdv helps overcome this limitation by maintaining a collection of DPI-specific images and switching them automatically when the application runs on screens with different DPI settings.

The sample uses a WinForms interface with ribbon and toolbar elements to visually demonstrate how images adapt seamlessly as DPI changes.

What This Sample Demonstrates

• How to configure ImageListAdv for DPI-aware image handling
• How to provide separate images for different DPI scaling values
• How controls automatically retrieve the correct image from ImageListAdv
• How to prevent image blurring on high-resolution displays
• How to build DPI-aware WinForms applications without manual scaling logic

Key Components Used

• ImageListAdv: Stores default and DPI-specific image resources
• DPIAwareImage: Maps images to specific DPI values
• Ribbon / Button controls: Consume images from ImageListAdv
• WinForms Form: Hosts and displays the DPI-aware UI

How It Works

1. Default images are added to the ImageListAdv image collection.
2. DPI-specific images are registered using DPIAwareImage entries.
3. Each DPI-aware image is mapped to the corresponding default image index.
4. UI controls reference images only by index, not by DPI.
5. At runtime, ImageListAdv automatically selects the correct image based on the current DPI.

Benefits

• Ensures crisp, clear images on all display resolutions
• Improves visual quality on high-DPI monitors
• Eliminates the need for manual image scaling
• Simplifies DPI handling for complex WinForms UIs
• Ideal for modern desktop applications with rich visuals

This approach is especially useful for WinForms applications that rely heavily on icons, toolbars, or ribbon controls and must deliver a consistent visual experience across multiple DPI environments.