Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BaseGallery.FirstItemVertAlignment Property

Gets or sets the first gallery item’s vertical position beyond which this item cannot be moved when scrolling backwards. (When the gallery is horizontally oriented (see GalleryControlGallery.Orientation), the FirstItemVertAlignment property defines the first item’s horizontal position.

Namespace: DevExpress.XtraBars.Ribbon.Gallery

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(GalleryItemAlignment.Near)]
[DXCategory("Behavior")]
public GalleryItemAlignment FirstItemVertAlignment { get; set; }

#Property Value

Type Default Description
GalleryItemAlignment Near

A GalleryItemAlignment value that specifies the item’s vertical or horizontal position.

Available values:

Name Description
Near

A gallery item is aligned to the near edge of the parent control.

Center

A gallery item is centered.

Far

A gallery item is aligned to the far edge of the parent control.

Custom

A gallery item is custom aligned.

#Remarks

The FirstItemVertAlignment and BaseGallery.LastItemVertAlignment properties can be used to change visual scroll bounds.

For galleries whose items are oriented vertically (by default), these properties work as follows. The FirstItemVertAlignment property specifies the visual vertical position where the first item is displayed when the gallery’s contents are scrolled to the top. The BaseGallery.LastItemVertAlignment property defines the visual vertical position where the last item is displayed when the gallery’s contents are scrolled to the bottom.

Specific galleries can be transposed (see GalleryControlGallery.Orientation). For horizontally oriented galleries, the FirstItemVertAlignment and BaseGallery.LastItemVertAlignment properties define the horizontal positions of the first and last items when the gallery’s contents are scrolled to the left and right edges, respectively.

When the FirstItemVertAlignment property is set to Custom, the actual position is specified by the BaseGallery.FirstItemVertIndent property. The same applies to the BaseGallery.LastItemVertAlignment property. If it’s set to Custom, the actual position is specified by the BaseGallery.LastItemVertIndent property.

See Also