windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-gallery-dot-standalonegallery-114e187a.md
Gets or sets a gallery’s auto-size mode, which determines the gallery’s initial size.
Namespace : DevExpress.XtraBars.Ribbon.Gallery
Assembly : DevExpress.XtraBars.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue(GallerySizeMode.Default)]
[DXCategory("Layout")]
public GallerySizeMode AutoSize { get; set; }
<DXCategory("Layout")>
<DefaultValue(GallerySizeMode.Default)>
Public Property AutoSize As GallerySizeMode
| Type | Default | Description |
|---|---|---|
| GallerySizeMode | Default |
A GallerySizeMode value.
|
Available values:
| Name | Description |
|---|---|
| Default |
The same as the GallerySizeMode.None option.
| | None |
A dropdown gallery cannot be resized.
| | Vertical |
A dropdown gallery can only be resized vertically.
| | Both |
Allows a dropdown gallery to be resized horizontally and vertically.
|
After enabling an auto-size mode ( GallerySizeMode.Vertical or GallerySizeMode.Both ), the gallery is immediately resized (if possible) to match the selected auto-size mode. This, however, doesn’t prevent the gallery from being resized afterwards.
The following table describes the available auto-size modes:
|
Gallery Size Mode
|
Description
| | --- | --- | |
Vertical
|
The gallery’s width is changed (if possible) to fit the number of columns specified by the BaseGallery.ColumnCount property. The number of rows is determined automatically, based on the column number. See the note below.
| |
Both
|
The gallery’s width and height are resized (if possible) to fit the number of columns and rows (specified by the ColumnCount and RowCount properties). If the actual number of items is less than ColumnCount, the gallery’s width is reduced (if possible) to fit the actual number of columns.
| |
Default
|
The same as the None option.
| |
None
|
The gallery’s size remains as is.
|
Note
By default, when gallery resizing is enabled, the maximum number of visible columns is not limited by the BaseGallery.ColumnCount property.
You can limit the number of visible columns for a GalleryControl‘s gallery. This can be accomplished by setting the GalleryControlGallery.AutoFitColumns property to false.
See Also