Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ImageCollection.GetImageSize Event

When the ImageCollection.IsDpiAware option is enabled, the GetImageSize event allows you to customize the size of images returned by the ImageCollection. This event is fired on finishing an ImageCollection object initialization.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v24.2.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

#Declaration

[DXCategory("Events")]
public event ImageCollectionGetImageSizeEventHandler GetImageSize

#Event Data

The GetImageSize event's data class is DevExpress.Utils.ImageCollectionGetImageSizeEventArgs.

#Remarks

This event is in effect when the ImageCollection.IsDpiAware option is set to True.

In normal DPI mode (96DPI), the size of images in the ImageCollection is specified by the ImageCollection.ImageSize property. When DPI is set to higher values, the images are scaled accordingly. For instance, the 120DPI setting corresponds to the scale factor of 1.25. If the ImageSize property is set to (16,16), the actual image size in 120DPI will be (20,20).

The GetImageSize event allows you to specify a custom image size for various DPI settings. The current DPI setting is returned by the event’s Dpi parameter. To provide a custom image size, use the SetScaleFactor method provided by the event’s argument. The default scale factor is identified by the event’s ScaleFactor property.

See Also