StandaloneGallery.AutoSize Property
Gets or sets a gallery’s auto-size mode, which determines the gallery’s initial size.
Namespace: DevExpress.XtraBars.Ribbon.Gallery
Assembly: DevExpress.XtraBars.v19.1.dll
Declaration
[DefaultValue(GallerySizeMode.Default)]
[DXCategory("Layout")]
public GallerySizeMode AutoSize { get; set; }Property Value
| 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. |
Remarks
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:
GallerySizeMode value | 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 same as the Vertical option, except the following: 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.