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.v24.1.dll
NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation
Declaration
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 |
|
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.