Skip to main content
A newer version of this page is available. .

XRControl.SizeF Property

Gets or sets the size of the control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.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;
}

The following code snippets (auto-collected from DevExpress Examples) contain references to the SizeF property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also