XRShape.Stretch Property

Gets or sets a value indicating whether or not to stretch a shape to fill its client area when it’s rotated.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[Browsable(true)]
[DefaultValue(false)]
[SRCategory(ReportStringId.CatBehavior)]
public bool Stretch { get; set; }

VB.NET

<SRCategory(ReportStringId.CatBehavior)>
<Browsable(True)>
<DefaultValue(False)>
Public Property Stretch As Boolean

Property Value

Type	Default	Description
Boolean	false	true to stretch the shape; otherwise, false.

Remarks

Use the Stretch property to determine whether a shape’s image should be stretched to fit the entire size of a control. Otherwise, its proportions should be preserved.

Note

Note that the Stretch property is in effect only if the shape is rotated (its XRShape.Angle property value is different from 0).

Example

This example demonstrates how to create the XRShape Arrow type control, and set its basic properties.

Tip

Online Example: How to insert a shape control into a report

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraReports.UI;
using DevExpress.XtraPrinting.Shape;
//...

private void button1_Click(object sender, EventArgs e) {
    XtraReport1 report = new XtraReport1();

    // Create a shape control.
    XRShape shape = new XRShape();

    // Set the shape's type to Arrow.
    shape.Shape = new ShapeArrow();

    // Adjust the Arrow shape's main properties.
    shape.Angle = 90;
    shape.Width = 200;
    shape.Height = 200;
    shape.ForeColor = Color.Brown;
    shape.FillColor = Color.Beige;
    shape.Stretch = false;

    // Adjust the Arrow shape's specific properties.
    ((ShapeArrow)shape.Shape).ArrowHeight = 50;
    ((ShapeArrow)shape.Shape).ArrowWidth = 50;
    ((ShapeArrow)shape.Shape).Fillet = 20;

    // Preview the report.
    report.Detail.Controls.Add(shape);
    ReportPrintTool pt = new ReportPrintTool(report);
    pt.ShowPreviewDialog();
}

VB.NET

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraPrinting.Shape
'...

Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles button1.Click
    Dim report As New XtraReport1()

    ' Create a shape control.
    Dim shape As New XRShape()

    ' Set the shape's type to Arrow.
    shape.Shape = New ShapeArrow()

    ' Adjust the Arrow shape's main properties.
    shape.Angle = 90
    shape.Width = 200
    shape.Height = 200
    shape.ForeColor = Color.Brown
    shape.FillColor = Color.Beige
    shape.Stretch = False

    ' Adjust the Arrow shape's specific properties.
    CType(shape.Shape, ShapeArrow).ArrowHeight = 50
    CType(shape.Shape, ShapeArrow).ArrowWidth = 50
    CType(shape.Shape, ShapeArrow).Fillet = 20

    ' Preview the report.
    report.Detail.Controls.Add(shape)
    Dim pt As New ReportPrintTool(report)
    pt.ShowPreviewDialog()
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Stretch 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.

C#

reporting-winforms-insert-a-shape-control/CS/Form1.cs#L29

shape.FillColor = Color.Beige;
shape.Stretch = false;

VB.NET

reporting-winforms-insert-a-shape-control/VB/Form1.vb#L29

shape.FillColor = Color.Beige
shape.Stretch = False
' Adjust the Arrow shape's specific properties.