The requested page is not available for the requested platform. You are viewing the content for Default platform.

XRCheckBox.CheckState Property

Bindable. Gets or sets the current state of the XRCheckBox object.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

Declaration

[SRCategory(ReportStringId.CatData)]
[DefaultValue(CheckState.Unchecked)]
public CheckState CheckState { get; set; }
<SRCategory(ReportStringId.CatData)>
<DefaultValue(CheckState.Unchecked)>
Public Property CheckState As CheckState

Property Value

Type Default Description
CheckState

Unchecked

A CheckState enumeration value which determines the state of a checkbox.

Remarks

If this property is set to the Checked value the check box displays a check mark.

If this property is set to the Unchecked value the check box is empty.

If this property is set to the Indeterminate value and the XRCheckBox.Checked property is set to true the check box displays a shaded check mark.

Examples

The code sample below illustrates how to create an XRCheckBox control for a report.

using DevExpress.XtraReports.UI;
// ...

public XRCheckBox CreateXRCheckBox()
{
    // Create an XRCheckBox control.
    XRCheckBox xrCheckBox1 = new XRCheckBox();

    xrCheckBox1.ExpressionBindings.AddRange(new ExpressionBinding[] {
    // Bind the CheckState property to the UnitsInStock data field.
    new ExpressionBinding("BeforePrint", "CheckState", "Iif([UnitsInStock]>=1,\'Checked\', \'Unchecked\')"),
    // Change the control's text depending on the UnitsInStock data field value.
    new ExpressionBinding("BeforePrint", "Text", 
                          "Iif([UnitsInStock]>0,\'Units in Stock: \' + [UnitsInStock], \'None\')")});

    // Set the control size.
    xrCheckBox1.SizeF = new SizeF(150F, 20F);

    return xrCheckBox1;
}
See Also