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

XRControl.AnchorVertical Property

Specifies the vertical anchoring style of a report control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

[SRCategory(ReportStringId.CatBehavior)]
public virtual VerticalAnchorStyles AnchorVertical { get; set; }

#Property Value

Type Description
VerticalAnchorStyles

The style of vertical anchoring.

Available values:

Name Description
None

Does not anchor a control to the edges of its container.

Top

Anchores a control to the top edge of its container.

Bottom

Anchores a control to the bottom edge of its container.

Both

Anchores a control to the top and bottom edges of its container.

#Remarks

When you open the Preview, the control‘s height can change to fit the control’s content specified in the Designer. As a result, the position of controls below the grown/shrunk control can change. Use the AnchorVertical property to attach the top and/or bottom edges of the control to the edges of its container on a rendered document page. Set the value of this property to one of the VerticalAnchorStyles enumeration values. The following examples demonstrate how different values affect the anchoring:

The image below shows the initial report layout. Three XRLabel controls are located inside a panel. The top and bottom controls contain multiline text. Different values of the AnchorVertical property are set for the control in the middle.

anchor-vertical-layout

See how these values affect the position of this middle control when the report is rendered in Preview.

Note

Controls with enabled vertical anchoring are not anchored to the top/bottom edges of their containers when you change the rendered document in Preview. For example, if you change the report bottom margin, the control sizes do not adjust to the new report size even if their AnchorVertical property is set to Bottom or Both.

To adjust the control height to the control’s content size, use the control’s CanGrow and CanShrink properties. Note that these two properties are not in effect if you set the control’s AnchorVertical property to Bottom or Both.

The following descendants of the XRControl control do not implement the AnchorVertical property:

See Also