BaseGallery.ItemImageLayout Property

Gets or sets how a gallery item’s image is displayed within the item’s image area.

Namespace: DevExpress.XtraBars.Ribbon.Gallery

Assembly: DevExpress.XtraBars.v21.1.dll

Declaration

[DXCategory("Appearance")]
[DefaultValue(ImageLayoutMode.MiddleCenter)]
public ImageLayoutMode ItemImageLayout { get; set; }

Property Value

Type Default Description
ImageLayoutMode

MiddleCenter

An ImageLayoutMode value that specifies how a gallery item’s image is arranged.

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.

Remarks

An item’s image (GalleryItem.Image/GalleryItem.ImageIndex) can be zoomed, stretched or aligned to various edges of the item’s image area. Use the ItemImageLayout property to customize the image layout setting.

To learn how to specify a gallery item image’s area size, see BaseGallery.ImageSize.

See Also