CheckBoxProperties.ValueChecked Property

Gets or sets the value that represents the editor’s checked state.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

[DefaultValue(true)]
public object ValueChecked { get; set; }

VB.NET

<DefaultValue(True)>
Public Property ValueChecked As Object

Property Value

Type	Default	Description
Object	**true**	A Object value that represents the checked state of the check box editor.

Remarks

Use the ValueChecked property to specify the value which represents the checked state of the check box editor. This value is assigned to the editor’s ASPxEditBase.Value when the editor is switched to the checked state.

Note

• The ValueChecked property synchronizes its value with the editor’s ASPxCheckBox.ValueChecked property.
• The ValueChecked property is not in effect for the radio button.

Example

This example illustrates how to customize ASPxCheckBox and GridViewDataCheckColumn if database data is kept in a format different from Boolean.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/aspxgridview-how-to-customize-a-check-box-column-e4096

Default.aspx

<dx:ASPxGridView ID="grid" runat="server" AutoGenerateColumns="False" DataSourceID="xds"
    KeyFieldName="Oid">
    <Columns>
        <dx:GridViewCommandColumn VisibleIndex="0" ShowEditButton="True"/>
        <dx:GridViewDataTextColumn FieldName="Oid" ReadOnly="True" VisibleIndex="1" SortOrder="Ascending">
        </dx:GridViewDataTextColumn>
        <dx:GridViewDataTextColumn FieldName="Title" VisibleIndex="2" Visible="false">
            <EditFormSettings Visible="True" />
        </dx:GridViewDataTextColumn>
        <dx:GridViewDataCheckColumn FieldName="Allow" VisibleIndex="3">
            <PropertiesCheckEdit AllowGrayed="true" ValueType="System.String" ValueChecked="allowed"
                ValueUnchecked="not allowed" ValueGrayed="no information" />
        </dx:GridViewDataCheckColumn>
        <dx:GridViewDataCheckColumn FieldName="Active" VisibleIndex="4">
            <DataItemTemplate>
                <dx:ASPxCheckBox ID="chk" runat="server" AllowGrayed="true" ValueType="System.Int32"
                    ValueChecked="1" ValueUnchecked="-1" ValueGrayed="0" Value='<%# Eval("Active") %> '
                    OnInit="chk_Init">
                </dx:ASPxCheckBox>
            </DataItemTemplate>
            <EditFormSettings Visible="False" />
        </dx:GridViewDataCheckColumn>
    </Columns>
</dx:ASPxGridView>
<dx:XpoDataSource ID="xds" runat="server" TypeName="MyObject">
</dx:XpoDataSource>

XpoHelper.cs

static void CreateDefaultObjects() {
    using (UnitOfWork uow = GetNewUnitOfWork()) {
        MyObject obj = new MyObject(uow);
        obj.Title = "Test1";
        obj.Active = 1;
        obj.Allow = "allowed";

        obj = new MyObject(uow);
        obj.Title = "Test2";
        obj.Active = 0 ;
        obj.Allow = "allowed";

        obj = new MyObject(uow);
        obj.Title = "Test3";
        obj.Active = -1;
        obj.Allow = "no information";

        obj = new MyObject(uow);
        obj.Title = "Test4";
        obj.Active = 0;
        obj.Allow = "not allowed";

        uow.CommitChanges();
    }
}