Skip to main content

XRControl.SizeF Property

Gets or sets the size of the control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v22.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

[SRCategory(ReportStringId.CatLayout)]
[XRLocalizable(true)]
public virtual SizeF SizeF { get; set; }

Property Value

Type Description
SizeF

A SizeF value, specifying the control’s width and height.

Remarks

The size of the control is the size of the RectangleF object returned by the XRControl.BoundsF property of this control.

If the control’s XRControl.Parent property returns null (Nothing in Visual Basic), the control’s width and height are always measured in hundredths of inch. Otherwise, the control belongs to a report, and its width and height are measured in the units set by the XtraReport.ReportUnit property.

Not all descendants of the XRControl class use the SizeF property. For example, the Band class descendants ignore the SizeF property.

Note

Neither the XRControl.HeightF nor the XRControl.WidthF property can be set to a value that is less than 2 units.

Example

The following example demonstrates how to create an XRControl object and set some of its properties at runtime.

using System.Drawing;
using DevExpress.XtraReports.UI;
// ...

public XRControl CreateMyXRControl() {
    // Create a control.
    XRControl xrControl1 = new XRControl();

    // Set its background color.
    xrControl1.BackColor = Color.LightGray;

    // Set its border color.
    xrControl1.BorderColor = Color.Blue;

    // Make its left and right borders visible.
    xrControl1.Borders = DevExpress.XtraPrinting.BorderSide.Left |
        DevExpress.XtraPrinting.BorderSide.Right;

    // Set its border width (in pixels).
    xrControl1.BorderWidth = 10;

    // Set its location and size (in hundredths of an inch).
    xrControl1.LocationF = new PointF(200F, 100F);
    xrControl1.SizeF = new SizeF(300F, 150F);

    return xrControl1;
}
See Also