RepositoryItemCheckedComboBoxEdit.ForceUpdateEditValue Property

Gets or sets whether the check states of check items in the dropdown are automatically changed according to the new edit value.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v25.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Data")]
public virtual DefaultBoolean ForceUpdateEditValue { get; set; }

VB.NET

<DXCategory("Data")>
<DefaultValue(DefaultBoolean.Default)>
Public Overridable Property ForceUpdateEditValue As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A DefaultBoolean value that specifies check item synchronization mode.

Available values:

Name	Description	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

Remarks

The DefaultBoolean.Default option is regarded as DefaultBoolean.True when the editor’s edit value is bound to a data source, and as DefaultBoolean.False in unbound mode.

If the ForceUpdateEditValue property is set to DefaultBoolean.True, the check states of check items in the dropdown are automatically synchronized with the edit value. This is accomplished by calling the CheckedComboBoxEdit.RefreshEditValue method.

If the ForceUpdateEditValue property is set to DefaultBoolean.False, the items are not in sync with the edit value. You may need to call the CheckedComboBoxEdit.RefreshEditValue method to manually perform synchronization.

In unbound mode, to assign an edit value, we recommend using the CheckedComboBoxEdit.SetEditValue method, which also performs all necessary synchronization.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ForceUpdateEditValue property.

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#

xaf-how-to-display-an-enumeration-property-as-a-drop-down-box-with-check-boxes/CS/EFCore/EnumCheckBoxEF/EnumCheckBoxEF.Win/Editors/EnumPropertyEditorEx.cs#L33

CheckedComboBoxEdit checkedEdit = new CheckedComboBoxEdit();
checkedEdit.Properties.ForceUpdateEditValue = DevExpress.Utils.DefaultBoolean.True;
return checkedEdit;