Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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

NuGet Package: DevExpress.Win.Navigation

#Declaration

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

#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.

See Also