Skip to main content
.NET 6.0+

ImageLoader.CustomizeImageInfo Event

Occurs when image metadata is retrieved via the ImageLoader‘s Get…ImageInfo methods. Allows you to customize the metadata.

Namespace: DevExpress.ExpressApp.Utils

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

public event EventHandler<CustomizeImageInfoEventArgs> CustomizeImageInfo

Event Data

The CustomizeImageInfo event's data class is CustomizeImageInfoEventArgs. The following properties provide information specific to this event:

Property Description
ImageFolder Specifies the folder which contains the retrieved image.
ImageInfo Supplies metadata information on the retrieved image.
ImageName Specifies the name of the retrieved image.
ImageSource Specifies the Image Source from which the image was retrieved.
IsEnabled Specifies whether the retrieved image is converted to grayscale.
MakeTransparent Specifies whether the retrieved image should be made transparent.

Remarks

For instance, you can handle this event if you want to enable transparency support for a specific image. Handle the CustomizeImageInfo event and set the CustomizeImageInfoEventArgs.MakeTransparent property to true.

ImageLoader.Instance.CustomizeImageInfo += ImageLoader_CustomizeImageInfo;
//...
void ImageLoader_CustomizeImageInfo(object sender, CustomizeImageInfoEventArgs e) {
    if(e.ImageName == "MyIncorrectlyDisplayedImage") e.MakeTransparent = true;            
}
See Also