WinExplorerViewOptionsImageLoad.AllowReplaceableImages Property

Gets or sets whether or not the WinExplorerView is allowed to replace missing images by scaling available images to the required size.

Namespace : DevExpress.XtraGrid.WinExplorer

Assembly : DevExpress.XtraGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Grid, DevExpress.Win.Navigation

csharp

[DefaultValue(true)]
public bool AllowReplaceableImages { get; set; }

<DefaultValue(True)>
Public Property AllowReplaceableImages As Boolean

Property Value

Type	Default	Description
Boolean	true

true if the WinExplorerView is allowed to replace missing images by scaling available images to the required size; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AllowReplaceableImages
WinExplorerView

.OptionsImageLoad .AllowReplaceableImages

Remarks

The WinExplorer View provides properties for a maximum of four columns containing images of different sizes (small, medium, large and extra large). These columns are assigned to corresponding properties in the WinExplorerView.ColumnSet section. The View chooses to use this or that specific image size depending on the currently applied View style (the WinExplorerViewOptionsView.Style property). By default, if the image of the size required for this specific style is missing, the View will search for a bigger image, shrink it and show it for this item. If there is no larger image found, the View will take a smaller image instead and scale it up to the required size. This mechanism is described in the Column Set group of the WinExplorer View topic.

The AllowReplaceableImages property disables this behavior and forces the View to use only the image from the column that is appropriate for this style, or display nothing if no image was found. For instance, if you apply the WinExplorerViewStyle.Tiles style and set the AllowReplaceableImages property to false , the View will use images contained within the WinExplorerViewColumns.MediumImageColumn only. This allows you to use [Asynchronous Image Loading] for missing images.