BaseCheckedListBoxControl.ConvertCheckValue Event

Occurs when the field value is fetched from the data source and then posted back.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

C#

[DXCategory("Behavior")]
public event ConvertCheckValueEventHandler ConvertCheckValue

VB.NET

<DXCategory("Behavior")>
Public Event ConvertCheckValue As ConvertCheckValueEventHandler

Event Data

The ConvertCheckValue event's data class is DevExpress.XtraEditors.ConvertCheckValueEventArgs.

Remarks

You can bind the BaseCheckedListBoxControl to a data source, using the BaseListBoxControl.DataSource property. In this case, you can use the BaseCheckedListBoxControl.CheckMember property to specify a data source field name whose values specify check box states. Typically, the field specified by the BaseCheckedListBoxControl.CheckMember property should be of the Boolean or Nullable<Boolean> type. If the field is of another type, you can convert it to the Boolean or Nullable<Boolean> type with the ConvertCheckValue event.

The ConvertCheckValue event fires in two cases:

• When a field value is fetched from the BaseListBoxControl.DataSource. In this case, the event’s ConvertCheckValueEventArgs.IsGet property returns true.
• When a check value is posted back to the data source. In this case, the event’s ConvertCheckValueEventArgs.IsSet property returns true.

Use ConvertCheckValueEventArgs.Value property to get or set the current value. A value assigned to this property should be of the Nullable<Boolean> or Boolean type.