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

Declaration

[DefaultValue(GallerySizeMode.Default)]
[DXCategory("Layout")]
public GallerySizeMode AutoSize { get; set; }
<DXCategory("Layout")>
<DefaultValue(GallerySizeMode.Default)>
Public Property AutoSize As GallerySizeMode

Property Value

Type Default Description
GallerySizeMode

Default

A GallerySizeMode value.

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.

See Also