BrickGraphics.DrawCheckBox(RectangleF, Boolean) Method

Adds a specific CheckBoxBrick to a report.

Namespace: DevExpress.XtraPrinting

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

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public CheckBoxBrick DrawCheckBox(
    RectangleF rect,
    bool check
)

VB.NET

Public Function DrawCheckBox(
    rect As RectangleF,
    check As Boolean
) As CheckBoxBrick

Parameters

Name	Type	Description
rect	RectangleF	The RectangleF structure that specifies the location and size of the current brick in measurement units, specified via the BrickGraphics.PageUnit property value.
check	Boolean	true, if the checkbox is in a checked state, otherwise, false.

Returns

Type	Description
CheckBoxBrick	The CheckBoxBrick added to a report.

Remarks

This method adds a specific CheckBoxBrick to a report. CheckBoxBrick position and size are specified via the rect parameter. After creation, the checkbox appears in the center of the generated CheckBoxBrick. If this brick size is larger than the size of the checkbox, then the entire brick area, except the checkbox, will be populated with the color specified via the backColor parameter value. A user can create checkboxes in two states: checked and unchecked . The check parameter value defines the manner in which the checkbox is displayed. Graphical settings which are not defined via this method are obtained from the corresponding BrickGraphics properties.

Example

This example demonstrates how to create a CheckBoxBrick using the BrickGraphics.DrawCheckBox method.

C#

using DevExpress.XtraPrinting;
// ...

    VisualBrick visBrick;
    BrickGraphics brickGraph = printingSystem1.Graph;

    // Start the report generation.
    printingSystem1.Begin();

    // Create a rectangle.
    RectangleF rect = new RectangleF(new PointF(0, 0), new SizeF(60, 20));

    // Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail;

    // Add a checkbox brick to the report.
    visBrick = brickGraph.DrawCheckBox(rect, BorderSide.All, SystemColors.ControlLight, true);

    // Finish the report generation.
    printingSystem1.End();

    // Preview the report
    printingSystem1.PreviewFormEx.Show();

VB.NET

Imports DevExpress.XtraPrinting
' ...

    Dim visBrick As VisualBrick
    Dim brickGraph As BrickGraphics = printingSystem1.Graph

    ' Start the report generation.
    printingSystem1.Begin()

    ' Create a rectangle.
    Dim rect As RectangleF = New RectangleF(New PointF(0, 0), New SizeF(60, 20))

    ' Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail

    ' Add a checkbox brick to the report.
    visBrick = brickGraph.DrawCheckBox(rect, BorderSide.All, SystemColors.ControlLight, True)

    ' Finish the report generation.
    printingSystem1.End()

    ' Preview the report.
    printingSystem1.PreviewFormEx.Show()

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DrawCheckBox(RectangleF, Boolean) method.

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-handle-link-events/CS/UseLinkEvents/Form1.cs#L94

// Draw a check box brick with the unchecked mark.
e.Graph.DrawCheckBox(new Rectangle(150, 0, 50, 50), false);

VB.NET

reporting-winforms-handle-link-events/VB/UseLinkEvents/Form1.vb#L97

' Draw a check box brick with the unchecked mark.
e.Graph.DrawCheckBox(New Rectangle(150, 0, 50, 50), False)