WinExplorerViewOptionsView.ImageLayoutMode Property

Gets or sets the WinExplorer View item image layout mode.

Namespace: DevExpress.XtraGrid.WinExplorer

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

C#

[DefaultValue(ImageLayoutMode.Default)]
[XtraSerializableProperty]
public ImageLayoutMode ImageLayoutMode { get; set; }

VB.NET

<DefaultValue(ImageLayoutMode.Default)>
<XtraSerializableProperty>
Public Property ImageLayoutMode As ImageLayoutMode

Property Value

Type	Default	Description
ImageLayoutMode	Default	An ImageLayoutMode enumerator value that specifies the WinExplorer View item image layout mode.

Available values:

Show 16 items

Name	Description
TopLeft	An image is vertically aligned at the top, and horizontally aligned on the left.
TopCenter	An image is vertically aligned at the top, and horizontally aligned at the center.
TopRight	An image is vertically aligned at the top, and horizontally aligned on the right.
MiddleLeft	An image is vertically aligned at the center, and horizontally aligned on the left.
MiddleCenter	An image is horizontally and vertically aligned at the center.
MiddleRight	An image is vertically aligned at the center, and horizontally aligned on the right.
BottomLeft	An image is vertically aligned at the bottom, and horizontally aligned on the left.
BottomCenter	An image is vertically aligned at the bottom, and horizontally aligned at the center.
BottomRight	An image is vertically aligned at the bottom, and horizontally aligned on the right.
Stretch	An image is stretched to fill the available client area.
ZoomInside	Zooms an image proportionally so that it’s displayed within the client area in its entirety.
ZoomOutside	Zooms an image proportionally, making its smaller side (width or height) to be displayed entirely. The image is centered, so the larger side (height or width) will not be displayed in its entirety.
StretchHorizontal	An image is stretched horizontally.
StretchVertical	An image is stretched vertically.
Default	The default layout.
Squeeze	An image is displayed as is, if its actual size is smaller than the size of the container. If the image size is larger than the container’s size, the image is shrunk proportionally to fit the container’s bounds.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ImageLayoutMode
WinExplorerView	.OptionsView .ImageLayoutMode

Remarks

If images within a column assigned to the corresponding property in the WinExplorerView.ColumnSet properties section do not fit the current image area, they can be clipped or stretched depending on the ImageLayoutMode property value. By default, images are stretched in the ZoomInside mode.

To set a custom image area size, use the WinExplorerViewStyleOptions.ImageSize property in the corresponding WinExplorerView.OptionsViewStyles section (e.g., the WinExplorerViewStyleOptionsCollection.Large or WinExplorerViewStyleOptionsCollection.Content section).