BrickGraphics.DrawLine(PointF, PointF, Color, Single) Method

Adds a specific LineBrick object to a document.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v24.1.Core.dll

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public LineBrick DrawLine(
    PointF pt1,
    PointF pt2,
    Color foreColor,
    float width
)

VB.NET

Public Function DrawLine(
    pt1 As PointF,
    pt2 As PointF,
    foreColor As Color,
    width As Single
) As LineBrick

Parameters

Name	Type	Description
pt1	PointF	A PointF object specifying where the line starts.
pt2	PointF	A PointF object specifying where the line ends.
foreColor	Color	A Color object specifying the line’s color.
width	Single	A float value specifying the line’s width.

Returns

Type	Description
LineBrick	A LineBrick object that represents the line drawn in the document.

Remarks

The line’s width is measured in three hundredths of an inch (1/300).

Example

The following example demonstrates how to draw a line in a Printing System document. The first way to do this is to use the BrickGraphics.DrawLine method, that is specially designed to draw lines easily. In addition, you can use the more common approach, by drawing a LineBrick via the BrickGraphics.DrawBrick method.

The code below illustrates how this can be done.

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraPrinting;
// ...


namespace LineBrickAndDrawLine {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            printControl1.PrintingSystem = ps;
        }

        private void btnDrawLine_Click(object sender, EventArgs e) {
            // Prepare for creating a document.
            ps.Begin();
            BrickGraphics gr = ps.Graph;
            gr.Modifier = BrickModifier.Detail;

            // Draw a line with the specified coordinates, foreground color and thickness.
            LineBrick brick = gr.DrawLine(new PointF(0, 0), new PointF(200, 200), Color.Red, 5);

            // Change the line style to dash-dot-dot.
            brick.LineStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

            // Hide brick borders.
            brick.BorderWidth = 0;

            // Finish creating the document.
            ps.End();
        }

        private void btnDrawBrick_Click(object sender, EventArgs e) {
            // Prepare for creating a document.
            ps.Begin();
            BrickGraphics gr = ps.Graph;
            gr.Modifier = BrickModifier.Detail;

            // Create a new line brick.
            LineBrick brick = new LineBrick();

            // Specify its properties.
            brick.Rect = new RectangleF(0, 0, 200, 200);
            brick.LineDirection = DevExpress.XtraReports.UI.LineDirection.BackSlant;
            brick.ForeColor = Color.Red;
            brick.LineWidth = 5;
            brick.LineStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;
            brick.BorderWidth = 0;

            // Draw this brick.
            gr.DrawBrick(brick);

            // Finish creating the document.
            ps.End();
        }
    }
}

VB.NET

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraPrinting
' ...


Namespace LineBrickAndDrawLine
    Partial Public Class Form1
        Inherits Form
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
        Handles MyBase.Load
            printControl1.PrintingSystem = ps
        End Sub

        Private Sub btnDrawLine_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles btnDrawLine.Click
            ' Prepare for creating a document.
            ps.Begin()
            Dim gr As BrickGraphics = ps.Graph
            gr.Modifier = BrickModifier.Detail

            ' Draw a line with the specified coordinates, foreground color and thickness.
            Dim brick As LineBrick = gr.DrawLine(New PointF(0, 0), New PointF(200, 200), _
                Color.Red, 5)

            ' Change the line style to dash-dot-dot.
            brick.LineStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot

            ' Hide brick borders.
            brick.BorderWidth = 0

            ' Finish creating the document.
            ps.End()
        End Sub

        Private Sub btnDrawBrick_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles btnDrawBrick.Click
            ' Prepare for creating a document.
            ps.Begin()
            Dim gr As BrickGraphics = ps.Graph
            gr.Modifier = BrickModifier.Detail

            ' Create a new line brick.
            Dim brick As New LineBrick()

            ' Specify its properties.
            brick.Rect = New RectangleF(0, 0, 200, 200)
            brick.LineDirection = DevExpress.XtraReports.UI.LineDirection.BackSlant
            brick.ForeColor = Color.Red
            brick.LineWidth = 5
            brick.LineStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot
            brick.BorderWidth = 0

            ' Draw this brick.
            gr.DrawBrick(brick)

            ' Finish creating the document.
            ps.End()
        End Sub
    End Class
End Namespace