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.v20.2.dll

Declaration

[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 the Asynchronous Image Load in WinExplorer and Tile Views feature for missing images.

See Also