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

C#

public event EventHandler<CustomizeImageInfoEventArgs> CustomizeImageInfo

VB.NET

Public Event CustomizeImageInfo As EventHandler(Of CustomizeImageInfoEventArgs)

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.

C#

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

VB.NET

Private ImageLoader.Instance.CustomizeImageInfo += AddressOf ImageLoader_CustomizeImageInfo
'...
Private Sub ImageLoader_CustomizeImageInfo(ByVal sender As Object, ByVal e As CustomizeImageInfoEventArgs)
    If e.ImageName = "MyIncorrectlyDisplayedImage" Then
        e.MakeTransparent = True
    End If
End Sub